CLI Referansı

sudo aihummer up
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
sudo aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

sudo aihummer set-password --login admin

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

`aihummer` Komut satırı aracı, bir ana bilgisayar yerel kurulumunu yönetir: geçidi başlatır ve günceller (kurulumun kendisi, hesap portalınızdan kişisel kurulum bağlantısı aracılığıyla yapılır), geçit systemd hizmetini kontrol eder, tanı çalıştırır, yedeklemeleri yönetir, kontrol düzlemi ayarlarını okur ve yazar ve lisansları imzalar. Bu sayfa her komutu listeler. ## Komutlar | Komut | Ne yapar | |---|---| | `up` / `install` | Gateway systemd servisini başlatın (`systemctl start`). Hiçbir şey yüklemez — yükleme, kişisel bağlantınızdan gelen yükleme betiği tarafından yapılır. | | `update [--check]` | En son sürüme güncelleyin (imzayı doğrulayın + ikiliyi değiştirin + yeniden başlatın); `--check` sadece bir güncellemenin mevcut olup olmadığını bildirir. | | `restart` | Ağ geçidi servisini yeniden başlat (`systemctl restart`). | | `stop` | Ağ geçidi servisini durdur (`systemctl stop`). | | `logs [unit] [--no-follow]` | Bir systemd biriminin günlüğünü takip et (`journalctl -u`); varsayılan olarak ağ geçidi birimini kullanır. `--no-follow` günlüğün sonunu yazdırır ve çıkar; onsuz komut takip etmeye devam eder. | | `status` | Kurulumun genel görünümü, hizmetlerin durumu ve ağ geçidinin hazır olması (`/readyz`). Bir **Bileşenler** bölümü, isteğe bağlı yan araç birimlerinin (arama, tarayıcı, konuşmadan metne, metinden konuşmaya, video) durumunu bildirir; `systemctl` kullanılamadığında durumun bilinmediğini dürüstçe söyler, "kurulu değil" demez. | | `doctor` | Üç sonuçlu tanılama: her şey yolunda, uyarılarla çalışıyor (N) veya sorun bulundu. Node.js ve filo kayıt malzemesi kontrolleri hata değil, uyarıdır. | | `backup [dir]` | `pg_dump` PostgreSQL durum düzlemini bir dosyaya; atlandığında varsayılan bir dizin kullanılır. | | `restore <file>` | Tarafından üretilen bir döküm dosyasından PostgreSQL'i geri yükle `backup`. | | `uninstall [flags]` | Kurulumu kaldırın (aşağıdaki bayraklara bakın). Root gerektirir — bunu ile çalıştırın `sudo`. | | `set-password` / `admin-password` | Yerel yönetici parolasını ayarla/oluştur (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Veritabanındaki okuma/yazma kontrol düzlemi ayarları — bu, Ayarlar-katalog düğmelerinin CLI'den nasıl yapılandırıldığını gösterir `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Lisansları yönetin: bir anahtar oluşturun, imzalayın, verilen bir token'ı çözümleyin ve doğrulayın. | | `loadtest` | Geçide karşı bir yük testi çalıştırın. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Eklenti SDK'sı: iskelet oluştur, doğrula, anahtarlar, paketle, imzala ve yayınla. | | `version` | Sürümü yazdır. | | `help` | Yardımı göster. | ### `uninstall` bayraklar | Bayrak | Etkisi | |---|---| | `--purge` | Ayrıca verileri de kaldırın (tam kaldırma). | | `--yes` | Onay istemini atla. | | `--no-backup` | Kaldırmadan önce yedek almayın. | | `--backup-dir <dir>` | Önceden kaldırma yedeğini bu dizine yazın. | ## Kullanım örnekleri ### Kur ve çalıştır Kurulum, hesap portalınızdaki kişisel kurulum bağlantısı aracılığıyla yapılır (bkz. [Kurulum](/tr/v1.0/getting-started/installation)); bundan sonra CLI başlar ve servisi kontrol eder: ```bash sudo aihummer up aihummer status ``` ### Güncelle ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Hizmet kontrolü ve günlükler Komutlar, tek geçit systemd birimi üzerinde işlem yapar (`AIHUMMER_SERVICE`, varsayılan `aihummer-gateway`); `logs` herhangi bir systemd birim adını kabul eder. ```bash sudo aihummer restart aihummer logs # the gateway unit's journal (default; follows) aihummer logs --no-follow # print the tail of the journal and exit aihummer logs aihummer-stt # another systemd unit's journal sudo aihummer stop ``` ### Teşhis ```bash aihummer doctor ``` ### Yedekleme ve geri yükleme `backup` çalıştırır `pg_dump` PostgreSQL durum düzlemini bir dosyaya; `restore` o döküm dosyasını alır. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres gerçeğin kaynağıdır, ancak sizin `AIHUMMER_MASTER_KEY` ve nokta > dizin ayrı olarak yedeklenmelidir — ana anahtar olmadan, şifrelenmiş > sırlar geri alınamaz. ### Yönetici şifresini ayarlayın Komut kabul eder `[--login admin] [--password X]` ve ihtiyaçlar `AIHUMMER_DATABASE_URL` — genellikle şu şekilde alınır `gateway.env` yükleme kullanıcısı olarak veya aracılığıyla çalıştırıldığında `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Kontrol düzlemi ayarları `settings` Ayarlar-katalog düğmelerini doğrudan veritabanında okur ve yazar — aynı mağaza, web yönetici UI'sinin (Yönetim → Ayarlar) düzenlediği yer. Katalog düğmeleri CLI'dan bu şekilde yapılandırılır: `gateway.env` Onlar için değerler dikkate alınmaz. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` sadece kullanıcıya görünen katalog anahtarlarını gösterir (sistem ve dahili anahtarlar gizlidir); her anahtar kaynağıyla etiketlenmiştir — `[db]` sizin belirlediğiniz değerler için, `[unset]` aksi takdirde katalog varsayılanıyla. ### Lisanslar `license show` gerektirir `<token>` argüman ve `AIHUMMER_LICENSE_PUBKEY` değişken: onu çözer ve doğrular **verilen** token — bu, örneğin mevcut lisansını göstermez. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Yük testi ```bash aihummer loadtest ``` ### Eklentiler ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish privately to your instance (public publishing is done in the portal — "My plugins") aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz ``` Tam SDK için ve portalden paylaşılan kataloğa yayınlamak için («Eklentilerim»), bakınız [Eklenti SDK](/tr/v1.0/marketplace/sdk) ve [Bir eklenti yayımlamak](/tr/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` root gerektirir: çalıştır `sudo aihummer uninstall`. Ve > `sudo aihummer uninstall --purge --yes` verileri kaldırır ve atlar > onay istemi — öncelikle doğrulanmış bir yedeğinizin olduğundan emin olun. ## Çevre Değişkenler `aihummer` araç kendisi okur: | Değişken | Amaç | |---|---| | `AIHUMMER_SERVICE` | Geçit systemd birim adı (varsayılan `aihummer-gateway`) — hedefi `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Ağ Geçidi URL'si için `status`/`doctor`/`loadtest` (varsayılan `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — tarafından gerekli `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI çıktısının ve yardımın dili: `ru` (varsayılan) veya `en`. | Çoğu komut root gerektirir (`systemctl`) — onları çalıştır `sudo`. ## Sonra nereye? - Örneği yapılandır: [Ortam değişkenleri](/tr/v1.0/reference/env-vars). - Ajanın kullanabileceği araçlara karar verin: [Araçlar kataloğu](/tr/v1.0/reference/tools-catalog).