Referință CLI

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

`aihummer` Instrumentul de linie de comandă gestionează o instalare nativă pe gazdă: pornește și actualizează gateway-ul (instalarea în sine se face prin linkul de instalare personal din portalul contului tău), controlează serviciul systemd al gateway-ului, rulează diagnostice, gestionează backup-uri, citește și scrie setările planului de control și semnează licențele. Această pagină listează fiecare comandă. ## Comenzi | Comandă | Ce face | |---|---| | `up` / `install` | Porniți serviciul systemd al gateway-ului (`systemctl start`). Nu instalează nimic — instalarea se face prin scriptul de instalare de la linkul tău personal. | | `update [--check]` | Actualizați la cea mai recentă versiune (verificați semnătura + înlocuiți fișierul binar + reporniți); `--check` raportează doar dacă există o actualizare disponibilă. | | `restart` | Repornirea serviciului gateway (`systemctl restart`). | | `stop` | Oprește serviciul gateway (`systemctl stop`). | | `logs [unit] [--no-follow]` | Urmărește jurnalul unei unități systemd (`journalctl -u`); implicit se setează la unitatea de gateway. `--no-follow` tipărește coada jurnalului și iese; fără el comanda continuă să urmărească. | | `status` | Prezentare generală a instalării, starea serviciilor și disponibilitatea gateway-ului (`/readyz`). O secțiune **Componente** raportează starea unităților sidecar opționale (căutare, browser, vorbire-în-text, text-în-vorbire, video); când `systemctl` nu este disponibil, spune sincer că starea este necunoscută, în loc de „neinstalat”. | | `doctor` | Diagnostic cu trei verdicte: totul în regulă, funcționează cu avertismente (N), sau probleme găsite. Verificările pentru Node.js și materialul de înregistrare în flotă sunt avertismente, nu eșecuri. | | `backup [dir]` | `pg_dump` starea PostgreSQL plane către un fișier; se utilizează un director implicit atunci când este omis. | | `restore <file>` | Restaurare PostgreSQL dintr-un fișier de dump generat de `backup`. | | `uninstall [flags]` | Eliminați instalarea (vedeți steagurile de mai jos). Necesită root — rulați-l cu `sudo`. | | `set-password` / `admin-password` | Setați/generați parola administratorului local (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Citirea/ scrierea setărilor planului de control în baza de date — așa se configurează butoanele din catalogul de setări din CLI în loc de `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Gestionați licențele: generați o cheie, semnați, decodați și verificați un token dat. | | `loadtest` | Rulează un test de încărcare împotriva gateway-ului. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK pentru plugin: configurează, validează, chei, pachet, semnează și publică. | | `version` | Tipărește versiunea. | | `help` | Afișează ajutor. | ### `uninstall` steaguri | Steag | Efect | |---|---| | `--purge` | De asemenea, eliminați datele (eliminare completă). | | `--yes` | Sari peste promptul de confirmare. | | `--no-backup` | Nu faceți o copie de siguranță înainte de a elimina. | | `--backup-dir <dir>` | Scrie backup-ul de dinaintea dezinstalării în acest director. | ## Exemple de utilizare ### Instalează și pornește Instalarea se face prin linkul de instalare personal din portalul contului dumneavoastră (vezi [Instalare](/ro/v1.0/getting-started/installation)); după aceea CLI pornește și verifică serviciul: ```bash sudo aihummer up aihummer status ``` ### Actualizare ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Controlul serviciului și jurnale Comenzile acționează asupra unității systemd a singurului gateway (`AIHUMMER_SERVICE`, implicit `aihummer-gateway`); `logs` acceptă orice nume de unitate systemd. ```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 ``` ### Diagnostic ```bash aihummer doctor ``` ### Backup și restaurare `backup` aleargă un `pg_dump` al planului de stare PostgreSQL într-un fișier; `restore` ia acel fișier dump. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres este sursa adevărului, dar al tău `AIHUMMER_MASTER_KEY` și bula > directorul trebuie să fie salvat separat — fără cheia principală, criptat > secretele nu pot fi recuperate. ### Setați parola de administrator Comanda acceptă `[--login admin] [--password X]` și nevoi `AIHUMMER_DATABASE_URL` — preluat în mod normal de la `gateway.env` când este rulat ca utilizatorul de instalare sau prin `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Setări ale planului de control `settings` citește și scrie direct în baza de date butoanele din catalogul Setări — aceeași stocare pe care o editează interfața web de administrare (Management → Setări). Așa se configurează butoanele din catalog din CLI: `gateway.env` valorile sunt ignorate pentru ele. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` afișează doar cheile catalogului vizibile utilizatorului (cheile de sistem și interne sunt ascunse); fiecare cheie este etichetată cu sursa sa — `[db]` pentru valorile pe care le setați, `[unset]` cu catalogul implicit altfel. ### Licențe `license show` necesită un `<token>` argumentul și `AIHUMMER_LICENSE_PUBKEY` variabilă: decodează și verifică **dat** token — nu afișează licența curentă a instanței. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Test de încărcare ```bash aihummer loadtest ``` ### Module ```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 ``` Pentru SDK-ul complet și pentru publicarea în catalogul partajat din portal («Pluginurile mele»), vezi [SDK pentru plugin](/ro/v1.0/marketplace/sdk) și [Publicarea unui plugin](/ro/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` necesită root: rulează `sudo aihummer uninstall`. Și > `sudo aihummer uninstall --purge --yes` elimină datele și sare peste > prompt de confirmare — asigură-te mai întâi că ai un backup verificat. ## Mediu Variabilele `aihummer` uneltele în sine citesc: | Variabilă | Scop | |---|---| | `AIHUMMER_SERVICE` | Numele unității gateway systemd (implicit `aihummer-gateway`) — ținta lui `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | URL-ul gateway-ului pentru `status`/`doctor`/`loadtest` (implicit `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | DSN Postgres — necesar de `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Limba ieșirii și a ajutorului CLI: `ru` (implicit) sau `en`. | Majoritatea comenzilor necesită root (`systemctl`) — rulează-le cu `sudo`. ## Unde următor? - Configurează instanța: [Variabile de mediu](/ro/v1.0/reference/env-vars). - Decide ce unelte poate folosi agentul: [Catalog de unelte](/ro/v1.0/reference/tools-catalog).