Odwołanie 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                 # dziennik jednostki bramy (domyślnie; śledzi)
aihummer logs --no-follow     # wypisz końcówkę dziennika i zakończ
aihummer logs aihummer-stt    # dziennik innej jednostki systemd
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

Ten `aihummer` Narzędzie wiersza poleceń zarządza natywną instalacją hosta: uruchamia i aktualizuje bramę (sama instalacja odbywa się za pomocą osobistego linku instalacyjnego z portalu twojego konta), kontroluje usługę systemd bramy, uruchamia diagnostykę, obsługuje kopie zapasowe, odczytuje i zapisuje ustawienia płaszczyzny kontrolnej oraz podpisuje licencje. Ta strona wymienia wszystkie polecenia. ## Polecenia | Polecenie | Co to robi | |---|---| | `up` / `install` | Uruchom usługę systemd bramy (`systemctl start`). Nic nie instaluje — instalacja jest wykonana przez skrypt instalacyjny z twojego osobistego linku. | | `update [--check]` | Aktualizuj do najnowszej wersji (zweryfikuj podpis + zamień plik binarny + uruchom ponownie); `--check` informuje tylko, czy dostępna jest aktualizacja. | | `restart` | Uruchom ponownie usługę bramy (`systemctl restart`). | | `stop` | Zatrzymaj usługę bramy (`systemctl stop`). | | `logs [unit] [--no-follow]` | Śledź dziennik jednego jednostki systemd (`journalctl -u`); domyślnie do jednostki bramy. `--no-follow` wypisuje końcówkę dziennika i kończy działanie; bez tej flagi polecenie śledzi dalej. | | `status` | Przegląd instalacji, stan usług i gotowość bramy (`/readyz`). Sekcja **Components** raportuje stan opcjonalnych jednostek sidecar (wyszukiwanie, przeglądarka, mowa-na-tekst, tekst-na-mowę, wideo); gdy `systemctl` jest niedostępny, uczciwie mówi, że stan jest nieznany, zamiast „nie zainstalowano”. | | `doctor` | Diagnostyka z trzema werdyktami: wszystko dobrze, działa z ostrzeżeniami (N), lub znaleziono problemy. Sprawdzenia Node.js i materiału rejestracji we flocie to ostrzeżenia, a nie błędy. | | `backup [dir]` | `pg_dump` stan PostgreSQL do pliku; domyślny katalog jest używany, gdy jest pominięty. | | `restore <file>` | Przywróć PostgreSQL z pliku zrzutu utworzonego przez `backup`. | | `uninstall [flags]` | Usuń instalację (zobacz poniższe flagi). Wymaga uprawnień root — uruchom ją z `sudo`. | | `set-password` / `admin-password` | Ustaw/wygeneruj lokalne hasło administratora (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Odczyt/zapis ustawień płaszczyzny sterowania w bazie danych — w ten sposób pokrętła katalogu ustawień są konfigurowane z CLI zamiast `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Zarządzaj licencjami: generuj klucz, podpisuj, dekoduj i weryfikuj podany token. | | `loadtest` | Przeprowadź test obciążeniowy bramki. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK wtyczki: tworzenie szkieletu, walidacja, klucze, pakowanie, podpisywanie i publikowanie. | | `version` | Wydrukuj wersję. | | `help` | Pokaż pomoc. | ### `uninstall` flagi | Flaga | Efekt | |---|---| | `--purge` | Usuń także dane (pełne usunięcie). | | `--yes` | Pomiń monit potwierdzenia. | | `--no-backup` | Nie wykonuj kopii zapasowej przed usunięciem. | | `--backup-dir <dir>` | Zapisz kopię zapasową przed odinstalowaniem w tym katalogu. | ## Przykłady użycia ### Zainstaluj i uruchom Instalacja odbywa się za pomocą osobistego linku instalacyjnego z Twojego panelu konta (zobacz [Instalacja](/pl/v1.0/getting-started/installation)); po tym CLI uruchamia się i sprawdza usługę: ```bash sudo aihummer up aihummer status ``` ### Aktualizacja ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Kontrola i logi usług Polecenia działają na pojedynczej jednostce systemd bramy (`AIHUMMER_SERVICE`, domyślnie `aihummer-gateway`); `logs` akceptuje dowolną nazwę jednostki systemd. ```bash sudo aihummer restart aihummer logs # dziennik jednostki bramy (domyślnie; śledzi) aihummer logs --no-follow # wypisz końcówkę dziennika i zakończ aihummer logs aihummer-stt # dziennik innej jednostki systemd sudo aihummer stop ``` ### Diagnostyka ```bash aihummer doctor ``` ### Kopia zapasowa i przywracanie `backup` prowadzi `pg_dump` stanu płaszczyzny PostgreSQL do pliku; `restore` bierze ten plik zrzutu. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres jest źródłem prawdy, ale twój `AIHUMMER_MASTER_KEY` i plama > katalog musi być kopią zapasową osobno — bez klucza głównego, zaszyfrowany > tajemnic nie da się odzyskać. ### Ustaw hasło administratora Polecenie akceptuje `[--login admin] [--password X]` i potrzeby `AIHUMMER_DATABASE_URL` — zwykle pobierane z `gateway.env` gdy uruchomione jako użytkownik instalacyjny lub za pośrednictwem `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Ustawienia płaszczyzny sterowania `settings` odczytuje i zapisuje ustawienia katalogu w bazie danych — w tym samym sklepie, który edytuje interfejs administracyjny sieci Web (Management → Settings). Tak konfiguruje się ustawienia katalogu z poziomu CLI: `gateway.env` wartości są dla nich ignorowane. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` pokazuje tylko klucze katalogu widoczne dla użytkownika (klucze systemowe i wewnętrzne są ukryte); każdy klucz jest oznaczony jego źródłem — `[db]` dla wartości, które ustawisz, `[unset]` w przeciwnym razie z domyślnym katalogiem. ### Licencje `license show` wymaga `<token>` argument i `AIHUMMER_LICENSE_PUBKEY` zmienna: dekoduje i weryfikuje **dany** token — nie wyświetla bieżącej licencji instancji. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Test obciążeniowy ```bash aihummer loadtest ``` ### Wtyczki ```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 ``` Aby uzyskać pełny zestaw SDK i opublikować w katalogu współdzielonym z portalu («Moje wtyczki»), zobacz [SDK wtyczki](/pl/v1.0/marketplace/sdk) i [Publikowanie wtyczki](/pl/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` wymaga uprawnień roota: uruchom `sudo aihummer uninstall`. I > `sudo aihummer uninstall --purge --yes` usuwa dane i pomija > monit potwierdzający — upewnij się najpierw, że masz zweryfikowaną kopię zapasową. ## Środowisko Zmienne te `aihummer` samodzielne narzędzie odczytuje: | Zmienna | Cel | |---|---| | `AIHUMMER_SERVICE` | Nazwa jednostki systemd bramy (domyślna `aihummer-gateway`) — cel `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Adres URL bramy dla `status`/`doctor`/`loadtest` (domyślny `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — wymagany przez `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Język wyjścia i pomocy CLI: `ru` (domyślny) lub `en`. | Większość poleceń wymaga uprawnień root (`systemctl`) — uruchom je za pomocą `sudo`. ## Dokąd dalej - Skonfiguruj instancję: [Zmienne środowiskowe](/pl/v1.0/reference/env-vars). - Zdecyduj, jakich narzędzi może używać agent: [Katalog narzędzi](/pl/v1.0/reference/tools-catalog).