Referință CLI

aihummer install
aihummer status

# Verifică doar dacă există o versiune mai nouă
aihummer update --check

# Aplică actualizarea
aihummer update

aihummer restart
aihummer logs                 # all services
aihummer logs gateway         # one service
aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/backup-2026-06-26.tar

aihummer set-password

aihummer settings set AIHUMMER_STT_URL http://localhost: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          # show the current license

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) or publicly (PR to the catalog)
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz
aihummer plugin publish --public --dir ./my-plugin --key author.key \
  --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \
  --description "..." --icon https://you.example/icon.svg

Instrumentul de linie de comandă `aihummer` gestionează o instalare nativă pe gazdă: pornește și actualizează gateway-ul (instalarea propriu-zisă se face prin linkul personal de instalare din contul personal), controlează serviciile systemd, rulează diagnostice, gestionează backupurile, citește și scrie setările control-plane și semnează licențe. Această pagină listează fiecare comandă. ## Comenzi | Comandă | Ce face | |---|---| | `up` / `install` | Pornește serviciul systemd al gateway-ului (`systemctl start`). Nu instalează nimic — instalarea o face scriptul de instalare de la linkul personal. | | `update [--check]` | Actualizează la cea mai recentă versiune; `--check` doar raportează dacă există o actualizare disponibilă. | | `restart` | Repornește serviciile. | | `stop` | Oprește serviciile. | | `logs [svc]` | Urmărește jurnalele; transmite un nume de serviciu pentru a filtra. | | `status` | Afișează starea serviciilor. | | `doctor` | Rulează diagnostice / verificări de sănătate. | | `backup [dir]` | Creează un backup (opțional într-un director țintă). | | `restore <file>` | Restaurează dintr-un fișier de backup. | | `uninstall [flags]` | Elimină instalarea (vezi opțiunile de mai jos). Necesită root — rulează cu `sudo`. | | `set-password` / `admin-password` | Setează parola administratorului local. | | `settings {set\|get\|list}` | Citește/scrie setările control-plane în baza de date — așa se setează parametrii Catalogului de setări din CLI, în loc de `gateway.env`. | | `license {keygen\|sign\|show}` | Gestionează licențe (generează cheie, semnează, afișează). | | `loadtest` | Rulează un test de încărcare împotriva gateway-ului. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK pentru pluginuri: schelet, validare, chei, împachetare, semnare și publicare (privat/public). | | `version` | Afișează versiunea. | | `help` | Afișează ajutorul. | ### Opțiuni `uninstall` | Opțiune | Efect | |---|---| | `--purge` | Elimină și datele (eliminare completă). | | `--yes` | Sare peste solicitarea de confirmare. | | `--no-backup` | Nu face backup înainte de eliminare. | | `--backup-dir <dir>` | Scrie backupul dinainte de dezinstalare în acest director. | ## Exemple de utilizare ### Instalare și pornire Instalarea o face linkul personal din contul personal (vezi [Instalare](/ro/v1.0/getting-started/installation)); după ea, CLI-ul pornește și verifică serviciul: ```bash aihummer install aihummer status ``` ### Actualizare ```bash # Verifică doar dacă există o versiune mai nouă aihummer update --check # Aplică actualizarea aihummer update ``` ### Controlul serviciilor și jurnalele ```bash aihummer restart aihummer logs # all services aihummer logs gateway # one service aihummer stop ``` ### Diagnostic ```bash aihummer doctor ``` ### Backup și restaurare ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/backup-2026-06-26.tar ``` > [!TIP] > Postgres este sursa de adevăr, dar `AIHUMMER_MASTER_KEY` și directorul de > blob-uri trebuie să fie salvate separat — fără cheia master, secretele > criptate nu pot fi recuperate. ### Setarea parolei de administrator ```bash aihummer set-password ``` ### Setări ```bash aihummer settings set AIHUMMER_STT_URL http://localhost:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` afișează doar cheile destinate utilizatorului din Catalogul de setări (cele de sistem și de serviciu sunt ascunse); la fiecare cheie este marcată sursa — `[db]` pentru valorile setate de tine și `[unset]` cu valoarea implicită. ### Licențe ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show # show the current license ``` ### Test de încărcare ```bash aihummer loadtest ``` ### Pluginuri ```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) or publicly (PR to the catalog) aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz aihummer plugin publish --public --dir ./my-plugin --key author.key \ --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \ --description "..." --icon https://you.example/icon.svg ``` Pentru SDK-ul complet și ambele moduri de publicare, vezi [SDK pentru pluginuri](/en/v1.0/marketplace/sdk) și [Publicarea unui plugin](/en/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` necesită root: rulează `sudo aihummer uninstall`. Iar > `sudo aihummer uninstall --purge --yes` elimină datele și sare peste > solicitarea de confirmare — asigură-te mai întâi că ai un backup verificat. ## Unde mergi mai departe - Configurează ce instalează CLI-ul: [Variabile de mediu](/en/v1.0/reference/env-vars). - Decide ce instrumente poate folosi agentul: [Catalog de instrumente](/en/v1.0/reference/tools-catalog).