CLI Çäresi

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

Şu `aihummer` bu komanda setirli gurallary myhman hozurluk gurşawynda dolandyýar: ugratmagy we täzelemegi başlangyç edýär (gurnama özügi öz hisap portalyňyzdan persownal gurma baglanyşygy arkaly amala aşyrylýar), geçelge systemd hyzmatyny dolandyryp biler, diagnostikany işledýär, ätiýaçlyk nusgalaryny işläp biler, kontrol meýdançasynyň sazlamalaryny okaýar we ýazýar, we lisenziýalary gol goýýar. Bu sahypa her bir komandany sanap geçýär. ## Buýruklar | Buýruk | Ol näme edýär | |---|---| | `up` / `install` | Gateway systemd hyzmatyny başla (`systemctl start`). Hiç zat gurnamaýar — gurnama şahsy baglaňyzdan alnan gurnama skripti arkaly ýerine ýetirilýär. | | `update [--check]` | Iň soňky nashra täzeläň (golbarmyny barlaň + binariýany çalşyň + täzeden başlaň); `--check` diňe täzelenişiň barlygyny habar berýär. | | `restart` | Gateway hyzmatyny täzeden başlat (`systemctl restart`). | | `stop` | Gapy hyzmatyny duruz (`systemctl stop`). | | `logs [unit] [--no-follow]` | Bir systemd birliginiň gündeligini öňe sürüň (`journalctl -u`); göz öňünde tutulmasa, geçelge enjamyna öňbaryjy bolýar. `--no-follow` gündeligiň soňuny çap edip çykýar; onsuz buýruk yzarlamagyny dowam etdirýär. | | `status` | Gurnamanyň umumy synlanyşy, hyzmatlaryň ýagdaýy we geçelgäniň taýýarlygy (`/readyz`). **Komponentler** bölümi islege bagly sidecar birlikleriniň ýagdaýyny habar berýär (gözleg, brauzer, sözden-tekste, teksten-sese, wideo); `systemctl` elýeterli bolmadyk ýagdaýynda «gurnalmadyk» diýmegiň ýerine ýagdaýyň nämälimdigini dogruçyl aýdýar. | | `doctor` | Üç netijeli diagnostika: hemme zat gowy, duýduryşlar bilen işleýär (N), ýa-da meseleler tapyldy. Node.js we flotda hasaba alnyş materialy barlaglary şowsuzlyk däl-de, duýduryşdyr. | | `backup [dir]` | `pg_dump` PostgreSQL döwlet meýdanyny faýla ýazdyrmak; goýberilende standart bukja ulanylýar. | | `restore <file>` | PostgreSQL-i döreden dump faýldan dikeltmek `backup`. | | `uninstall [flags]` | Gurnamany öňünden aýyr (aşakdaky flaglara serediň). Root talap edýär — ony bilen işlediň `sudo`. | | `set-password` / `admin-password` | Ýerli admin parolyny düzmek/gosmak (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Maglumatlar bazasyndaky okamak/ýazmak bilen gözegçilik etmek sazlamalary — Settings-katalog düwmeleri CLI arkaly nähili sazlanýandygyny şeýle edýär `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Lisenziýalary dolandyryň: açar dörediň, gol çekiň, berlen tokeni dekodirleň we barlaň. | | `loadtest` | Şlüz garşy ýüklemeli synag geçiriň. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: skelet döretmek, tassyklamak, açarlar, paketleşdirmek, gol çekmek we neşir etmek. | | `version` | Wersiýasyny çap et. | | `help` | Kömek görkez. | ### `uninstall` baýraklar | baýdak | Täsir | |---|---| | `--purge` | Maglumatlary hem aýyryň (doly aýyrmak). | | `--yes` | Tassyklamak soragyny geç. | | `--no-backup` | Pozmazdan öň ätiýaçlyk nusga almagyň. | | `--backup-dir <dir>` | Öňce programma öçürilmezden öňgi ätiýaçlyk nusgasyny bu kataloga ýazdyryň. | ## Ulanyş mysallary ### Gurnap işgäri getir Gurnama, hasabyňyzdaky şahsy gurnama baglanyşygy arkaly amala aşyrylýar (görmek [Gurnama](/tk/v1.0/getting-started/installation)); şondan soň CLI başlaýar we hyzmaty barlaýar: ```bash sudo aihummer up aihummer status ``` ### Täzeläp bilmek ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Hyzmat dolandyryşy we ýazgylary Bu buýruklar birikme gapysy systemd birligine täsir edýär (`AIHUMMER_SERVICE`, standart `aihummer-gateway`); `logs` her haýsydyr bir systemd birliginiň adyny kabul edýär. ```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 ``` ### Diagnostika ```bash aihummer doctor ``` ### Ekinligi saklamak we dikeltmek `backup` işledýär `pg_dump` PostgreSQL döwleti meýdanyny faýla geçirmek; `restore` şol çökgünlik faýlyny alýar. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres hakyky çeşmedir, ýöne siziň `AIHUMMER_MASTER_KEY` we blob > sanylary aýratyn goralmaly — esasy açarsyz, şifrlenen > syrlary gaýtadan almak bolup bilmez. ### Admin parolyny goýuň Bu buýrugy kabul edýär `[--login admin] [--password X]` we zerur `AIHUMMER_DATABASE_URL` — adatça alnan `gateway.env` gurnama ulanyjysy hökmünde işledileninde ýa-da arkaly `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Dolandyryş düzülmeleri `settings` Ýgtyýar edilýär we ýazylýar Settings-katalog düwmelerini göni maglumatlar bazasynda — web administratiw interfeýsiň (Dolandyryş → Sazlamalar) üýtgetmeler girizýän şol bir dükanda. Katalog düwmeleri CLI arkaly şeýle sazlanýar: `gateway.env` bahalar olary üçin göz öňünde tutulmaýar. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` diňe ulanyjy görýän katalog açarlaryny görkezýär (hereketde we içki açarlar gizlenýär); her bir açar onuň çeşmesi bilen bellidir — `[db]` siziň kesgitleýän gymmatlaryňyz üçin, `[unset]` başga ýagdaýda katalogyň defolt bilen. ### Lisenziýalar `license show` talap edýär `<token>` argument we `AIHUMMER_LICENSE_PUBKEY` üreýji: ol kodlap çözýär we barlaýar **berilen** token — bu nusganyň öňki lisenziýasynyň häzirki ýagdaýyny görkezmeýär. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Ýük synagy ```bash aihummer loadtest ``` ### Goşundular ```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 ``` Dolulygyna SDK üçin we portaldan paýlaşylan kataloga çap etmek («Meniň goşundym»), serediň [Plugin SDK](/tk/v1.0/marketplace/sdk) we [Plugin-i neşir etmek](/tk/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` root talap edilýär: işlet `sudo aihummer uninstall`. We > `sudo aihummer uninstall --purge --yes` mälimatlary aýyrýar we geçýär > tassyklama beýannamasy — ilkinji nobatda tassyklanan ätiýaçlyk nusgaňyz barlygyna göz ýetiriň. ## Tejribe Üýtgeýänler `aihummer` gurnak özüni şeýle okar: | Üýtgeýän | Maksat | |---|---| | `AIHUMMER_SERVICE` | Şlýuz systemd birliginiň ady (standart `aihummer-gateway`) — nyşana alnan `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Gapy URL-i üçin `status`/`doctor`/`loadtest` (başlangyç `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — gerekli bolup durýar `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI çykyşynyň we kömeginiň dili: `ru` (standart) ýa-da `en`. | Käbir komandalar kök rugsady talab edýär (`systemctl`) — olary bilen işlediň `sudo`. ## Indi nire? - Instansyny düzmek: [Çevre üýtgeýjileri](/tk/v1.0/reference/env-vars). - Agentiň haýsy enjamlary ulanyp biljekdigine karar beriň: [Gurnama katalogy](/tk/v1.0/reference/tools-catalog).