CLI İstinadı

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

O `aihummer` komanda sətri aləti host-yerli quraşdırmanı idarə edir: o, gateway-i işə salır və yeniləyir (quraşdırma özlüyündə hesab portalınızdan şəxsi quraşdırma linki vasitəsilə həyata keçirilir), gateway systemd xidmətini idarə edir, diaqnostika aparır, ehtiyat nüsxələri idarə edir, idarəetmə təyyarəsi parametrlərini oxuyur və yazır, və lisenziyaları imzalayır. Bu səhifədə hər bir əmr sadalanır. ## Əmrler | Əmr | Nə edir | |---|---| | `up` / `install` | Gateway systemd xidmətini işə salın (`systemctl start`). Heç nə quraşdırmır — quraşdırma sizin şəxsi linkinizdən olan quraşdırma skripti tərəfindən həyata keçirilir. | | `update [--check]` | Ən son buraxılışa yeniləyin (imzanı yoxlayın + ikilik faylı dəyişdirin + yenidən başladın); `--check` yalnız yeniləmənin mövcud olub-olmadığını bildirir. | | `restart` | Gateway xidmətini yenidən başlat (`systemctl restart`). | | `stop` | Gateway xidmətini dayandırın (`systemctl stop`). | | `logs [unit] [--no-follow]` | Bir systemd vahidinin jurnalını izləyin (`journalctl -u`); standart olaraq şlüz vahidinə keçir. `--no-follow` jurnalın son sətirlərini çap edib çıxır; onsuz əmr izləməyə davam edir. | | `status` | Quraşdırmanın icmalı, xidmətlərin vəziyyəti və şlüzün hazırlığı (`/readyz`). **Komponentlər** bölməsi isteğe bağlı yan maşın vahidlərinin (axtarış, brauzer, nitqdən mətnə, mətndən nitqə, video) vəziyyətini bildirir; `systemctl` əlçatan olmadıqda «quraşdırılmayıb» əvəzinə vəziyyətin naməlum olduğunu dürüst deyir. | | `doctor` | Üç hökmlü diaqnostika: hər şey qaydasındadır, xəbərdarlıqlarla işləyir (N), yaxud problemlər tapılıb. Node.js və flot qeydiyyat materialı yoxlamaları xəbərdarlıqdır, uğursuzluq deyil. | | `backup [dir]` | `pg_dump` PostgreSQL dövlət planını bir fayla; əgər qeyd edilməzsə, standart kataloq istifadə olunur. | | `restore <file>` | Dump faylı tərəfindən yaradılmış PostgreSQL-i bərpa edin `backup`. | | `uninstall [flags]` | Quraşdırmanı çıxarın (aşağıdakı bayraqlara baxın). Köklü icazə tələb olunur — onu ilə işlədin `sudo`. | | `set-password` / `admin-password` | Yerel administrator şifrəsini təyin edin/yaradın (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Məlumat bazasında oxumaq/yazmaq idarəetmə planı parametrləri — bu, Parametrlər-kataloq düymələrinin CLI-dən necə tənzimləndiyi yollarıdır `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Lisenziyaları idarə edin: açar yaradın, imzalayın, verilmiş tokeni dekod edin və doğrulayın. | | `loadtest` | Şlüzə qarşı yük testi həyata keçirin. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: skelet hazırlamaq, yoxlamaq, açarlar, paket, imzalamaq və nəşr etmək. | | `version` | Versiyanı çap et. | | `help` | Kömək göstər. | ### `uninstall` bayraqlar | Bayraq | Təsir | |---|---| | `--purge` | Həmçinin məlumatı silin (tamamilə silin). | | `--yes` | Təsdiq sorğusunu keç. | | `--no-backup` | Silinməzdən əvvəl ehtiyat nüsxə götürməyin. | | `--backup-dir <dir>` | Quraşdırmadan əvvəl ehtiyat nüsxəni bu qovluğa yazın. | ## İstifadə nümunələri ### Quraşdır və işə sal Quraşdırma hesab portalınızdakı şəxsi quraşdırma linki vasitəsilə həyata keçirilir (bax [Quraşdırma](/az/v1.0/getting-started/installation)); bundan sonra CLI başlayır və xidməti yoxlayır: ```bash sudo aihummer up aihummer status ``` ### Yeniləmə ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Xidmətin idarə olunması və qeydlər Əmrlər tək qapı sistemi systemd vahidinə təsir edir (`AIHUMMER_SERVICE`, standart `aihummer-gateway`); `logs` hər hansı systemd bölmə adını qəbul edir. ```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 ``` ### Diaqnostika ```bash aihummer doctor ``` ### Yedəkləmə və bərpa `backup` işlədir `pg_dump` PostgreSQL dövlət müstəvisindən fayla; `restore` o tullantı faylını götürür. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres həqiqətin mənbəyidir, amma sizin `AIHUMMER_MASTER_KEY` və ləkə > kataloq ayrıca ehtiyat nüsxələnməlidir — əsas açarsız, şifrələnmiş > sirlər bərpa oluna bilməz. ### Admin şifrəsini təyin edin Əmr qəbul edir `[--login admin] [--password X]` və ehtiyacları `AIHUMMER_DATABASE_URL` — adətən götürülür `gateway.env` quraşdırma istifadəçisi kimi və ya vasitəsilə işlədildikdə `sudo`. ```bash sudo aihummer set-password --login admin ``` ### İdarəetmə təyyarəsinin parametrləri `settings` parametrlər kataloqu düymələrini birbaşa verilənlər bazasında oxuyur və yazır — veb inzibatçı UI (İdarəetmə → Parametrlər) tərəfindən redaktə olunan eyni mağaza. Kataloq düymələrinin CLI-dən necə konfiqurasiya edildiyi budur: `gateway.env` dəyərlər onlar üçün nəzərə alınmır. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` yalnız istifadəçi qarşısında görünən kataloq açarlarını göstərir (sistem və daxili açarlar gizlədilib); hər açar mənbəyi ilə işarələnir — `[db]` təyin etdiyiniz dəyərlər üçün, `[unset]` Əks halda kataloqun defoltuyla. ### Lisenziyalar `license show` tələb edir `<token>` mübahisə və `AIHUMMER_LICENSE_PUBKEY` dəyişən: onu dekodlaşdırır və yoxlayır **verilmiş** token — bu instansiyanın cari lisenziyasını göstərmir. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Yükləmə testi ```bash aihummer loadtest ``` ### Plaginlər ```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 üçün və portaldan («Mənim plaginlərim») paylaşılan kataloqa nəşr etmək üçün baxın [Plugin SDK](/az/v1.0/marketplace/sdk) və [Plugin dərc etmək](/az/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` root tələb edir: işlət `sudo aihummer uninstall`. Və > `sudo aihummer uninstall --purge --yes` məlumatları silir və keçir > təsdiq sorğusu — əvvəlcə yoxlanılmış ehtiyat nüsxəniz olduğundan əmin olun. ## Ətraf mühit Dəyişənlər `aihummer` alət özündə oxuyur: | Dəyişən | Məqsəd | |---|---| | `AIHUMMER_SERVICE` | Şlüz systemd bölməsi adı (əvvəlcədən təyin olunmuş `aihummer-gateway`) — hədəfi `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Ünvan əlaqəsi üçün `status`/`doctor`/`loadtest` (dəyişilməz `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — tələb olunur `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI çıxışının və yardımın dili: `ru` (susmaya görə) və ya `en`. | Əksər əmrlər root tələb edir (`systemctl`) — onları ilə işlədin `sudo`. ## Növbəti haradır - Nümunəni konfiqurasiya edin: [Ətraf mühit dəyişənləri](/az/v1.0/reference/env-vars). - Agentin istifadə edə biləcəyi alətləri qərar verin: [Alətlər kataloqu](/az/v1.0/reference/tools-catalog).