CLI atsauce

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ārtejas vienības žurnāls (noklusējums; seko)
aihummer logs --no-follow     # izdrukāt žurnāla asti un iziet
aihummer logs aihummer-stt    # citas systemd vienības žurnāls
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

Tas `aihummer` Komandrindas rīks pārvalda saimniekdatora vietējo instalāciju: tas sāk un atjaunina vārteju (instalācija pati tiek veikta, izmantojot personīgo instalācijas saiti no jūsu konta portāla), kontrolē vārtejas systemd pakalpojumu, veic diagnostiku, pārvalda rezerves kopijas, lasa un raksta vadības slāņa iestatījumus un paraksta licences. Šī lapa uzskaita katru komandu. ## Komandas | Komanda | Ko tas dara | |---|---| | `up` / `install` | Sākt gateway systemd servisu (`systemctl start`). Tas neko neinstalē — instalēšanu veic instalācijas skripts no jūsu personīgās saites. | | `update [--check]` | Atjaunināt uz jaunāko versiju (pārbaudīt parakstu + nomainīt bināro failu + restartēt); `--check` tikai ziņo, vai ir pieejams atjauninājums. | | `restart` | Restartējiet vārtejas pakalpojumu (`systemctl restart`). | | `stop` | Apturiet vārtejas pakalpojumu (`systemctl stop`). | | `logs [unit] [--no-follow]` | Sekojiet vienas systemd vienības žurnālam (`journalctl -u`); noklusēti uz vārtejas vienību. `--no-follow` izdrukā žurnāla asti un iziet; bez tā komanda turpina sekot. | | `status` | Instalācijas pārskats, pakalpojumu stāvoklis un vārtejas gatavība (`/readyz`). Sadaļa **Komponenti** ziņo par izvēles blakusvāģu vienību stāvokli (meklēšana, pārlūks, runas pārvēršana tekstā, teksta pārvēršana runā, video); kad `systemctl` nav pieejams, tā godīgi saka, ka stāvoklis nav zināms, nevis "nav instalēts". | | `doctor` | Diagnostika ar trim verdiktiem: viss kārtībā, darbojas ar brīdinājumiem (N), vai atrastas problēmas. Node.js un flotes reģistrācijas materiāla pārbaudes ir brīdinājumi, nevis kļūmes. | | `backup [dir]` | `pg_dump` PostgreSQL valsts plakne uz failu; noklusējuma direktorija tiek izmantota, ja tā tiek izlaista. | | `restore <file>` | Atjaunot PostgreSQL no dublējuma faila, ko izveidojis `backup`. | | `uninstall [flags]` | Noņemiet instalēšanu (skatīt zemāk norādītās karogus). Prasa root — palaidiet to ar `sudo`. | | `set-password` / `admin-password` | Iestatīt/ģenerēt vietējā administratora paroli (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Lasīt/rakstīt vadības plāna iestatījumus datu bāzē — šādi tiek konfigurēti Iestatījumu kataloga slēdži no CLI, nevis `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Pārvaldīt licences: ģenerēt atslēgu, parakstīt, dekodēt un pārbaudīt doto tokenu. | | `loadtest` | Veiciet slodzes testu pret vārteju. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Spraudņa SDK: veidot karkasu, pārbaudīt, atslēgas, iepakot, parakstīt un publicēt. | | `version` | Izdrukāt versiju. | | `help` | Parādīt palīdzību. | ### `uninstall` karogi | Karogs | Ietekme | |---|---| | `--purge` | Tāpat noņemiet datus (pilnīga noņemšana). | | `--yes` | Izlaist apstiprinājuma uzvedni. | | `--no-backup` | Neveiciet dublējumu pirms noņemšanas. | | `--backup-dir <dir>` | Uzrakstiet pirms atinstalēšanas dublējumu šajā direktorijā. | ## Lietošanas piemēri ### Instalēt un palaist Instalācija tiek veikta, izmantojot personīgo instalēšanas saiti no jūsu konta portāla (skatīt [Uzstādīšana](/lv/v1.0/getting-started/installation)); pēc tam tiek startēts CLI un pārbauda pakalpojumu: ```bash sudo aihummer up aihummer status ``` ### Atjaunināt ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Pakalpojumu kontrole un žurnāli Komandas darbojas uz vienotā vārtejas systemd vienību (`AIHUMMER_SERVICE`, noklusējums `aihummer-gateway`); `logs` pieņem jebkuru systemd vienības nosaukumu. ```bash sudo aihummer restart aihummer logs # vārtejas vienības žurnāls (noklusējums; seko) aihummer logs --no-follow # izdrukāt žurnāla asti un iziet aihummer logs aihummer-stt # citas systemd vienības žurnāls sudo aihummer stop ``` ### Diagnostika ```bash aihummer doctor ``` ### Dublēšana un atjaunošana `backup` vada `pg_dump` no PostgreSQL stāvokļa plaknes uz failu; `restore` paņem to izgāztuves failu. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres ir patiesības avots, bet jūsu `AIHUMMER_MASTER_KEY` un kamols > katalogu jāveic atsevišķa dublēšana — bez galvenās atslēgas, šifrēts > noslēpumus nav iespējams atgūt. ### Iestatīt administratora paroli Komanda pieņem `[--login admin] [--password X]` un vajadzības `AIHUMMER_DATABASE_URL` — parasti iegūts no `gateway.env` kad tiek palaists kā instalēšanas lietotājs vai caur `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Kontroles plāna iestatījumi `settings` tieši lasa un raksta iestatījumu katalogu pogas datubāzē — tajā pašā veikalā, kuru rediģē tīmekļa administratora saskarne (Pārvaldība → Iestatījumi). Šādi katalogu pogas tiek konfigurētas no CLI: `gateway.env` vērtības tiek ignorētas attiecībā uz tām. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` rāda tikai lietotājam redzamās katalogu atslēgas (sistēmas un iekšējās atslēgas ir paslēptas); katra atslēga ir atzīmēta ar tās avotu — `[db]` vērtībām, kuras jūs iestatāt, `[unset]` citādi ar katalogu pēc noklusējuma. ### Licence `license show` prasa `<token>` arguments un `AIHUMMER_LICENSE_PUBKEY` mainīgais: tas atšifrē un pārbauda **dots** žetons — tas neparāda instanču pašreizējo licenci. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Slodzes tests ```bash aihummer loadtest ``` ### Spraudņi ```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 ``` Pilnajam SDK un publicēšanai koplietotajā katalogā no portāla («Mani spraudņi») skatīt [Spraudņa SDK](/lv/v1.0/marketplace/sdk) un [Spraudņa publicēšana](/lv/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` prasa root: palaist `sudo aihummer uninstall`. Un > `sudo aihummer uninstall --purge --yes` noņem datus un izlaist > apstiprinājuma uzvedne — vispirms pārliecinieties, ka jums ir pārbaudīta rezerves kopija. ## Vide Mainīgie `aihummer` pašrīks lasa: | Mainīgais | Mērķis | |---|---| | `AIHUMMER_SERVICE` | Vārtejas systemd vienības nosaukums (noklusējuma `aihummer-gateway`) — mērķis `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Vārtejas URL priekš `status`/`doctor`/`loadtest` (noklusējums `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — nepieciešams `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI izvades un palīdzības valoda: `ru` (noklusējums) vai `en`. | Lielākajai daļai komandu nepieciešamas root tiesības (`systemctl`) — palaidiet tos ar `sudo`. ## Kur uz nākamo - Konfigurēt instanci: [Vides mainīgie](/lv/v1.0/reference/env-vars). - Izlemiet, kādus rīkus aģents var izmantot: [Rīku katalogs](/lv/v1.0/reference/tools-catalog).