CLI viide

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                 # väravaühiku ajalugu (vaikimisi; jälgib edasi)
aihummer logs --no-follow     # trüki ajaloo lõpp ja välju
aihummer logs aihummer-stt    # mõne teise systemd ühiku ajalugu
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

See `aihummer` Käsurea tööriist haldab hosti-loomuliku installi: see käivitab ja värskendab väravat (installatsioon ise toimub teie konto portaalist saadud isikliku installi lingi kaudu), kontrollib värava systemd teenust, käivitab diagnostikat, haldab varukoopiaid, loeb ja kirjutab juhtpaneeli seadeid ning allkirjastab litsentsid. See leht loetleb kõik käsud. ## Käsud | Käsk | Mida see teeb | |---|---| | `up` / `install` | Käivita gateway systemd teenus (`systemctl start`). See ei installi midagi — paigaldamise teeb installatsiooniskript sinu isikliku lingi kaudu. | | `update [--check]` | Uuenda uusimale versioonile (kontrolli allkirja + vaheta binaarfail + taaskäivita); `--check` teatab ainult, kas uuendus on saadaval. | | `restart` | Taaskäivita värava teenus (`systemctl restart`). | | `stop` | Peata väravateenus (`systemctl stop`). | | `logs [unit] [--no-follow]` | Jälgi ühe systemd ühiku ajalugu (`journalctl -u`); vaikeväärtusena kasutatakse väravaühikut. `--no-follow` trükib ajaloo lõpu ja väljub; ilma selleta jälgib käsk edasi. | | `status` | Paigalduse ülevaade, teenuste olek ja värava valmisolek (`/readyz`). Jaotis **Komponendid** raporteerib valikuliste külgkorviühikute (otsing, brauser, kõnest tekstiks, tekst kõneks, video) oleku; kui `systemctl` pole saadaval, ütleb see ausalt, et olek on teadmata, mitte „pole paigaldatud". | | `doctor` | Diagnostika kolme otsusega: kõik korras, töötab hoiatustega (N) või leiti probleeme. Node.js-i ja laevastikuregistreerimise materjali kontrollid on hoiatused, mitte vead. | | `backup [dir]` | `pg_dump` PostgreSQL riigitasandi salvestamine faili; vaikimisi kausta kasutatakse, kui see on jäetud välja. | | `restore <file>` | Taasta PostgreSQL väljundfailist, mis on loodud `backup`. | | `uninstall [flags]` | Eemalda paigaldus (vt allolevaid lippe). Nõuab juurkasutajat — käivita see koos `sudo`. | | `set-password` / `admin-password` | Määra/genereri kohaliku administraatori parool (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Loe/kirjuta juhtimistasandi sätete seadeid andmebaasis — nii seadistatakse Settings-kataloogi nupud CLI-st selle asemel `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Haldage litsentse: looge võti, allkirjastage, dekodeerige ja kontrollige antud märki. | | `loadtest` | Käivita lävivõime test värava vastu. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: skafaldiseeri, valideeri, võtmed, paki, allkirjasta ja avalda. | | `version` | Trüki versioon. | | `help` | Näita abi. | ### `uninstall` lipud | Lipp | Tulemus | |---|---| | `--purge` | Eemalda ka andmed (täielik eemaldamine). | | `--yes` | Jäta kinnitusviip vahele. | | `--no-backup` | Ära tee varukoopiat enne eemaldamist. | | `--backup-dir <dir>` | Kirjutage eelneva desinstallimise varukoopia sellesse kataloogi. | ## Kasutusjuhud ### Paigalda ja käivita Paigaldamine toimub teie konto portaali isikliku installimislingi kaudu (vt [Paigaldus](/et/v1.0/getting-started/installation)); pärast seda käivitub CLI ja kontrollib teenust: ```bash sudo aihummer up aihummer status ``` ### Uuenda ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Teenuse kontroll ja logid Käsud toimivad ühe värava systemd ühikul (`AIHUMMER_SERVICE`, vaikimisi `aihummer-gateway`); `logs` võtab vastu suvalise systemd ühiku nime. ```bash sudo aihummer restart aihummer logs # väravaühiku ajalugu (vaikimisi; jälgib edasi) aihummer logs --no-follow # trüki ajaloo lõpp ja välju aihummer logs aihummer-stt # mõne teise systemd ühiku ajalugu sudo aihummer stop ``` ### Diagnostika ```bash aihummer doctor ``` ### Varundamine ja taastamine `backup` jookseb `pg_dump` PostgreSQL riigitasandi teisendamine faili; `restore` võtab selle prügifaili. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres on tõeallikas, aga teie `AIHUMMER_MASTER_KEY` ja laik > kaust tuleb varundada eraldi — ilma peavõtmeta, krüpteeritult > saladusi ei saa taastada. ### Määra administraatori parool Käsk aktsepteerib `[--login admin] [--password X]` ja vajadused `AIHUMMER_DATABASE_URL` — tavaliselt hangitud `gateway.env` kui käivitatakse installikasutajana või kaudu `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Kontroll-tasandi seaded `settings` loeb ja kirjutab seadete kataloogi nuppe otse andmebaasi — sama hoidla, mida veebihalduri liides (Haldu → Seaded) redigeerib. Selliselt konfigureeritakse kataloogi nuppe käsurealt: `gateway.env` neile väärtusi ei arvestata. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` näitab ainult kasutajale nähtavaid kataloogi võtmeid (süsteemi ja sisemised võtmed on peidetud); iga võti on märgistatud selle allikaga — `[db]` seadistatud väärtuste puhul, `[unset]` muul juhul kataloogi vaikeväärtusega. ### Litsentsid `license show` nõuab `<token>` argument ja `AIHUMMER_LICENSE_PUBKEY` muutuja: see dekodeerib ja kontrollib **antud** token — see ei kuva instantsi praegust litsentsi. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Koormustest ```bash aihummer loadtest ``` ### Lisandmoodulid ```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 ``` Täieliku SDK jaoks ja portaalist jagatud kataloogi avaldamiseks («Minu pluginad») vaata [Plugina SDK](/et/v1.0/marketplace/sdk) ja [Plugina avaldamine](/et/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` nõuab root'i: käivita `sudo aihummer uninstall`. Ja > `sudo aihummer uninstall --purge --yes` eemaldab andmed ja jätab vahele > kinnituse teade — veendu esmalt, et sul oleks kinnitatud varukoopia. ## Keskkond Muutujad `aihummer` ise tool loeb: | Muutuja | Eesmärk | |---|---| | `AIHUMMER_SERVICE` | Lüüsi systemd üksuse nimi (vaikimisi `aihummer-gateway`) — sihtmärk `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Lüüsi URL `status`/`doctor`/`loadtest` (vaikimisi `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — nõutav `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI väljundi ja abiteksti keel: `ru` (vaikimisi) või `en`. | Enamik käske vajab juurõigusi (`systemctl`) — käivita need koos `sudo`. ## Kuhu järgmine - Konfigureeri eksemplar: [Keskkonnamuutujad](/et/v1.0/reference/env-vars). - Otsustage, milliseid tööriistu agent saab kasutada: [Tööriistade kataloog](/et/v1.0/reference/tools-catalog).