CLI-referanse

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` Kommandolinjeverktøyet administrerer en vertsnativ installasjon: det starter og oppdaterer gatewayen (selve installasjonen gjøres via den personlige installasjonslenken fra kontopanelet ditt), kontrollerer gatewayens systemd-tjeneste, kjører diagnostikk, håndterer sikkerhetskopier, leser og skriver kontrollplansinnstillinger, og signerer lisenser. Denne siden lister opp alle kommandoene. ## Kommandoer | Kommando | Hva det gjør | |---|---| | `up` / `install` | Start gateway-systemtjenesten (`systemctl start`). Det installerer ingenting — installasjonen gjøres av installasjonsskriptet fra din personlige lenke. | | `update [--check]` | Oppdater til siste versjon (verifiser signatur + bytt binær + start på nytt); `--check` rapporterer bare om en oppdatering er tilgjengelig. | | `restart` | Start gateway-tjenesten på nytt (`systemctl restart`). | | `stop` | Stopp gateway-tjenesten (`systemctl stop`). | | `logs [unit] [--no-follow]` | Følg journalen til en systemd-enhet (`journalctl -u`); standardinnstilling er til gateway-enheten. `--no-follow` skriver ut slutten av journalen og avslutter; uten flagget fortsetter kommandoen å følge. | | `status` | Oversikt over installasjonen, tjenestenes tilstand og gatewayens beredskap (`/readyz`). En **Komponenter**-seksjon rapporterer tilstanden til de valgfrie sidevogn-enhetene (søk, nettleser, tale-til-tekst, tekst-til-tale, video); når `systemctl` ikke er tilgjengelig, sier den ærlig at tilstanden er ukjent i stedet for «ikke installert». | | `doctor` | Diagnostikk med tre utfall: alt i orden, kjører med advarsler (N), eller problemer funnet. Sjekkene for Node.js og flåteregistreringsmateriale er advarsler, ikke feil. | | `backup [dir]` | `pg_dump` PostgreSQL statlige plan til en fil; en standardmappe brukes når det utelates. | | `restore <file>` | Gjenopprett PostgreSQL fra en dumpfil produsert av `backup`. | | `uninstall [flags]` | Fjern installasjonen (se flaggene nedenfor). Krever root — kjør det med `sudo`. | | `set-password` / `admin-password` | Sett/generer lokal administratorpassord (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Les/skrive kontrollplaninnstillinger i databasen — dette er hvordan innstillinger-katalogkontroller konfigureres fra CLI i stedet for `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Administrer lisenser: generer en nøkkel, signer, dekod + verifiser en gitt token. | | `loadtest` | Kjør en belastningstest mot gatewayen. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: skjelett, valider, nøkler, pakk, signer og publiser. | | `version` | Skriv ut versjonen. | | `help` | Vis hjelp. | ### `uninstall` flagg | Flagg | Effekt | |---|---| | `--purge` | Fjern også data (fullstendig fjerning). | | `--yes` | Hopp over bekreftelsesmeldingen. | | `--no-backup` | Ikke ta en sikkerhetskopi før du fjerner. | | `--backup-dir <dir>` | Skriv forhåndsavinstallasjons-backupen til denne katalogen. | ## Brukseksempler ### Installer og start opp Installasjon gjøres via den personlige installasjonslenken fra kontopanelet ditt (se [Installasjon](/no/v1.0/getting-started/installation)); etter det starter CLI-en og sjekker tjenesten: ```bash sudo aihummer up aihummer status ``` ### Oppdatering ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Tjenestekontroll og logger Kommandoene virker på enkelt-gateway systemd-enheten (`AIHUMMER_SERVICE`, standard `aihummer-gateway`); `logs` aksepterer et hvilket som helst systemd-enhetsnavn. ```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 ``` ### Diagnostikk ```bash aihummer doctor ``` ### Sikkerhetskopiering og gjenoppretting `backup` driver en `pg_dump` av PostgreSQL-tilstandsplanet til en fil; `restore` tar den dumpfilen. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres er sannhetskilden, men din `AIHUMMER_MASTER_KEY` og bloben > katalogen må sikkerhetskopieres separat — uten hovednøkkelen, kryptert > hemmeligheter kan ikke gjenopprettes. ### Sett administratorpassordet Kommandoen aksepterer `[--login admin] [--password X]` og behov `AIHUMMER_DATABASE_URL` — vanligvis hentet fra `gateway.env` når kjørt som installasjonsbruker eller via `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Kontrollplaninnstillinger `settings` leser og skriver Settings-kataloginnstillinger direkte i databasen — den samme butikken som webadministrasjonsgrensesnittet (Administrasjon → Innstillinger) redigerer. Slik konfigureres kataloginnstillinger fra CLI: `gateway.env` verdier blir ignorert for 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` viser bare de brukervendte katalognøklene (system- og interne nøkler er skjult); hver nøkkel er merket med sin kilde — `[db]` for verdier du setter, `[unset]` med katalogstandard ellers. ### Lisenser `license show` krever en `<token>` argument og den `AIHUMMER_LICENSE_PUBKEY` variabel: den dekoder og verifiserer **gitt** token — den viser ikke instansens nåværende lisens. ```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 ``` ### Plugins ```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 ``` For den fullstendige SDK-en, og for publisering til den delte katalogen fra portalen («Mine plugins»), se [Plugin SDK](/no/v1.0/marketplace/sdk) og [Publisering av en plugin](/no/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` krever root: kjør `sudo aihummer uninstall`. Og > `sudo aihummer uninstall --purge --yes` fjerner data og hopper over > bekreftelsesforespørsel — sørg for at du har en verifisert sikkerhetskopi først. ## Miljø Variablene `aihummer` Verktøyet selv leser: | Variabel | Formål | |---|---| | `AIHUMMER_SERVICE` | Gateway-systemd-enhetsnavnet (standard `aihummer-gateway`) — målet for `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Gateway-URL for `status`/`doctor`/`loadtest` (standard `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — påkrevd av `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Språket for CLI-utdata og hjelp: `ru` (standard) eller `en`. | De fleste kommandoer trenger root (`systemctl`) — kjør dem med `sudo`. ## Hvor til neste - Konfigurer instansen: [Miljøvariabler](/no/v1.0/reference/env-vars). - Bestem hvilke verktøy agenten kan bruke: [Verktøykatalog](/no/v1.0/reference/tools-catalog).