CLI-referens

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

Den `aihummer` kommandoradsverktyget hanterar en värd-nativ installation: det startar och uppdaterar gatewayen (installationen själv görs via den personliga installationslänken från ditt kontopanel), kontrollerar gatewayens systemd-tjänst, kör diagnostik, hanterar säkerhetskopior, läser och skriver kontrollplansinställningar, och signerar licenser. Denna sida listar varje kommando. ## Kommandon | Kommando | Vad det gör | |---|---| | `up` / `install` | Starta gateway-systemd-tjänsten (`systemctl start`). Det installerar ingenting — installationen görs av installationsskriptet från din personliga länk. | | `update [--check]` | Uppdatera till den senaste versionen (verifiera signatur + byt binärfil + starta om); `--check` bara rapporterar om en uppdatering är tillgänglig. | | `restart` | Starta om gateway-tjänsten (`systemctl restart`). | | `stop` | Stoppa gatewaytjänsten (`systemctl stop`). | | `logs [unit] [--no-follow]` | Följ en systemd-enhets journal (`journalctl -u`); standardvärde är gateway-enheten. `--no-follow` skriver ut slutet av journalen och avslutar; utan flaggan fortsätter kommandot att följa. | | `status` | Översikt över installationen, tjänsternas tillstånd och gatewayens beredskap (`/readyz`). En sektion **Komponenter** rapporterar tillståndet för de valfria sidovagnsenheterna (sökning, webbläsare, tal-till-text, text-till-tal, video); när `systemctl` inte är tillgängligt säger den ärligt att tillståndet är okänt i stället för «inte installerad». | | `doctor` | Diagnostik med tre utlåtanden: allt väl, kör med varningar (N), eller problem hittade. Kontrollerna av Node.js och registreringsmaterialet för flottan är varningar, inte fel. | | `backup [dir]` | `pg_dump` PostgreSQL-statsplanet till en fil; en standardkatalog används när den utelämnas. | | `restore <file>` | Återställ PostgreSQL från en dumpfil som producerats av `backup`. | | `uninstall [flags]` | Ta bort installationen (se flaggorna nedan). Kräver root — kör det med `sudo`. | | `set-password` / `admin-password` | Ange/generera det lokala administratörslösenordet (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Läs/skriv kontrollplanens inställningar i databasen — så här konfigureras inställningskatalogens rattar från CLI istället för `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Hantera licenser: skapa en nyckel, signera, avkoda + verifiera en given token. | | `loadtest` | Kör ett belastningstest mot gatewayen. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: skapa skelett, validera, nycklar, paketera, signera och publicera. | | `version` | Skriv ut versionen. | | `help` | Visa hjälp. | ### `uninstall` flaggor | Flagga | Effekt | |---|---| | `--purge` | Ta även bort data (fullständig borttagning). | | `--yes` | Hoppa över bekräftelseprompten. | | `--no-backup` | Ta inte en säkerhetskopia innan du tar bort. | | `--backup-dir <dir>` | Skriv för-avinstallationsbackupen till den här katalogen. | ## Användningsexempel ### Installera och starta Installationen görs via den personliga installationslänken från ditt kontos portal (se [Installation](/sv/v1.0/getting-started/installation)); efter det startar CLI och kontrollerar tjänsten: ```bash sudo aihummer up aihummer status ``` ### Uppdatera ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Tjänstekontroll och loggar Kommandona verkar på den enskilda gateway-systemd-enheten (`AIHUMMER_SERVICE`, standard `aihummer-gateway`); `logs` accepterar vilket systemd-enhetsnamn som helst. ```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 ``` ### Diagnostik ```bash aihummer doctor ``` ### Säkerhetskopiering och återställning `backup` driver en `pg_dump` av PostgreSQL-statlig plan in i en fil; `restore` tar den dumpfilen. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres är sanningskällan, men din `AIHUMMER_MASTER_KEY` och blobben > katalogen måste säkerhetskopieras separat — utan huvudnyckeln, krypterad > hemligheter kan inte återställas. ### Ställ in administratörslösenordet Kommandot accepterar `[--login admin] [--password X]` och behov `AIHUMMER_DATABASE_URL` — normalt plockas upp från `gateway.env` när den körs som installationsanvändare eller via `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Kontrollplansinställningar `settings` läser och skriver inställningskatalogreglage direkt i databasen — samma lagring som webbadmingränssnittet (Management → Settings) redigerar. Så här konfigureras katalogreglage från CLI: `gateway.env` värden ignoreras för dem. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` visar endast de användarvänliga katalognycklarna (system- och interna nycklar är dolda); varje nyckel är märkt med sin källa — `[db]` för värden du anger, `[unset]` med katalogens standard annars. ### Licenser `license show` kräver en `<token>` argument och den `AIHUMMER_LICENSE_PUBKEY` variabel: den avkodar och verifierar **given** token — den visar inte instansens nuvarande licens. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Belastningstest ```bash aihummer loadtest ``` ### Tillägg ```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 ``` För hela SDK:n, och för publicering till den delade katalogen från portalen («Mina plugins»), se [Plugin-SDK](/sv/v1.0/marketplace/sdk) och [Publicera ett plugin](/sv/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` kräver root: kör `sudo aihummer uninstall`. Och > `sudo aihummer uninstall --purge --yes` tar bort data och hoppar över > bekräftelseuppmaning — se till att du först har en verifierad säkerhetskopia. ## Miljö Variablerna `aihummer` verktyget själv läser: | Variabel | Syfte | |---|---| | `AIHUMMER_SERVICE` | Gateway-systemd-enhetsnamnet (standard `aihummer-gateway`) — målet för `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Gateway-URL för `status`/`doctor`/`loadtest` (standard `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — krävs av `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Språk för CLI-utdata och hjälp: `ru` (standard) eller `en`. | De flesta kommandon kräver root (`systemctl`) — kör dem med `sudo`. ## Vart härnäst - Konfigurera instansen: [Miljövariabler](/sv/v1.0/reference/env-vars). - Bestäm vilka verktyg agenten kan använda: [Verktygskatalog](/sv/v1.0/reference/tools-catalog).