Даведнік CLI

aihummer install
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
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

Інструмент каманднага радка `aihummer` кіруе хост-натыўным усталяваннем: ён запускае і абнаўляе шлюз (сама ўсталёўка выконваецца па персанальнай спасылцы з асабістага кабінета), кіруе сэрвісамі systemd, запускае дыягностыку, апрацоўвае рэзервовыя копіі, чытае і піша налады control-plane і падпісвае ліцэнзіі. Гэтая старонка пералічвае кожную каманду. ## Каманды | Каманда | Што яна робіць | |---|---| | `up` / `install` | Запусціць systemd-сэрвіс шлюза (`systemctl start`). Нічога не ўсталёўвае — усталёўку выконвае ўсталёвачны скрыпт па персанальнай спасылцы. | | `update [--check]` | Абнавіць да апошняга рэлізу; `--check` толькі паведамляе, ці даступнае абнаўленне. | | `restart` | Перазапусціць сэрвісы. | | `stop` | Спыніць сэрвісы. | | `logs [svc]` | Сачыць за логамі; перадайце імя сэрвісу для фільтрацыі. | | `status` | Паказаць статус сэрвісу. | | `doctor` | Запусціць дыягностыку / праверкі здароўя. | | `backup [dir]` | Стварыць рэзервовую копію (па жаданні ў мэтавы каталог). | | `restore <file>` | Аднавіць з файла рэзервовай копіі. | | `uninstall [flags]` | Выдаліць усталяванне (глядзіце сцягі ніжэй). Патрабуе root — запускайце праз `sudo`. | | `set-password` / `admin-password` | Усталяваць лакальны пароль адміністратара. | | `settings {set\|get\|list}` | Чытаць/пісаць налады control-plane у БД — так параметры Каталога налад задаюцца з CLI замест `gateway.env`. | | `license {keygen\|sign\|show}` | Кіраваць ліцэнзіямі (генераваць ключ, падпісваць, паказваць). | | `loadtest` | Запусціць нагрузачны тэст супраць шлюза. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: скаффолд, валідацыя, ключы, упакоўка, падпіс і публікацыя (прыватная/публічная). | | `version` | Надрукаваць версію. | | `help` | Паказаць даведку. | ### Сцягі `uninstall` | Сцяг | Эфект | |---|---| | `--purge` | Таксама выдаліць дадзеныя (поўнае выдаленне). | | `--yes` | Прапусціць запыт пацверджання. | | `--no-backup` | Не рабіць рэзервовую копію перад выдаленнем. | | `--backup-dir <dir>` | Запісаць рэзервовую копію перад выдаленнем у гэты каталог. | ## Прыклады выкарыстання ### Усталяванне і запуск Усталёўку выконвае персанальная спасылка з асабістага кабінета (глядзіце [Усталёўку](/be/v1.0/getting-started/installation)); пасля яе CLI запускае і правярае сэрвіс: ```bash aihummer install aihummer status ``` ### Абнаўленне ```bash # Only check whether a newer release exists aihummer update --check # Apply the update aihummer update ``` ### Кіраванне сэрвісам і логі ```bash aihummer restart aihummer logs # all services aihummer logs gateway # one service aihummer stop ``` ### Дыягностыка ```bash aihummer doctor ``` ### Рэзервовае капіраванне і аднаўленне ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/backup-2026-06-26.tar ``` > [!TIP] > Postgres — гэта крыніца ісціны, але ваш `AIHUMMER_MASTER_KEY` і каталог блобаў > павінны рэзервавацца асобна — без майстар-ключа зашыфраваныя сакрэты немагчыма > аднавіць. ### Усталяванне пароля адміністратара ```bash aihummer set-password ``` ### Налады ```bash aihummer settings set AIHUMMER_STT_URL http://localhost:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` паказвае толькі карыстальніцкія ключы Каталога (сістэмныя і службовыя схаваны); у кожнага ключа пазначана крыніца — `[db]` для зададзеных вамі значэнняў і `[unset]` са значэннем па змаўчанні. ### Ліцэнзіі ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show # show the current license ``` ### Нагрузачны тэст ```bash aihummer loadtest ``` ### Плагіны ```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 ``` Поўны SDK і абодва рэжымы публікацыі глядзіце ў [Plugin SDK](/be/v1.0/marketplace/sdk) і [Публікацыі плагіна](/be/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` патрабуе root: запускайце `sudo aihummer uninstall`. А > `sudo aihummer uninstall --purge --yes` выдаляе дадзеныя і прапускае запыт > пацверджання — спачатку пераканайцеся, што ў вас ёсць правераная рэзервовая > копія. ## Куды далей - Наладзьце тое, што CLI ўсталёўвае: [Зменныя асяроддзя](/be/v1.0/reference/env-vars). - Вырашыце, якія інструменты можа выкарыстоўваць агент: [Каталог інструментаў](/be/v1.0/reference/tools-catalog).