CLI ахԥхьаӡара

sudo aihummer up
aihummer status

# Иҿыц арелиз ыҟоума акәзар ршьҭра мацара
aihummer update --check

# Аиҭагара ахархәара
sudo aihummer update

sudo aihummer restart
aihummer logs                 # агейтуэй аиԥшра ажурнал (хықәкулатәи)
aihummer logs aihummer-stt    # даҽа 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>            # манифест ашаблон (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # манифест аконтракт инақәыршәаны агәаҭара
aihummer plugin keygen                 # ed25519 автор акалит (.key + .pub)
aihummer plugin package ./my-plugin    # тарбол + .sha256 аргылара
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Акьыԥхьра: хатәла (шәинстанс ахь) ма зегьырзы (PR каталог ахь)
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` ахкоманда-цәаҳәатә амаҭәахәы инапхгоит host-native аиҿкаара: иаиҿкаауеит насгьы иҿыцуеит агейтуэй (аинсталл хаҭала ишьоуп шәахаҭалатә кабинет аҟынтәи хаҭалатә инсталл линк ала), инапхгоит агейтуэй иsystemd-амаҵзура, инагӡоит адиагностика, инапхгоит ахьчагақәа, иԥхьоит насгьы иҩуеит control-plane анашьамҭақәа, насгьы инапаҵаҩуеит алицензиақәа. Абри адаҟьа иарбоит акоманда зегьы. ## Акомандақәа | Акоманда | Иарбан аусура анагӡо | |---|---| | `up` / `install` | Агейтуэй systemd-амаҵзура иаиҿкаара (`systemctl start`). Акгьы иргылаӡом — аинсталл шәхаҭалатә линк аҟынтәи аинсталл скрипт ала ишьоуп. | | `update [--check]` | Иҵыхәтәи арелиз ахь аиҭагара (анышьҭ агәаҭара + абинар ахсра + аиҭадәықылара); `--check` ишьҭуеит арҿыцра иҟазар мацара. | | `restart` | Агейтуэй амаҵзура аиҭадәықылара (`systemctl restart`). | | `stop` | Агейтуэй амаҵзура аанкылара (`systemctl stop`). | | `logs [unit]` | Systemd аиԥшрак ажурнал зхыуа (`journalctl -u`); хықәкула — агейтуэй аиԥшра. | | `status` | Агейтуэй аазырхиара аҭагылазаашьа арбагара (`/readyz`). | | `doctor` | Адиагностика анагӡара (амаҵзура active + агейтуэй иазырхиоу). | | `backup [dir]` | PostgreSQL аҭагылазаашьа-хаҿы (state plane) `pg_dump` ала афаил ахь; аргумент ада хықәкулатәи акаталог ахархәоуп. | | `restore <file>` | PostgreSQL аиҭашьақәыргылара `backup` ала иаԥҵоу адамп-афаил аҟынтә. | | `uninstall [flags]` | Аинсталл аныхра (флагқәа алада урба). `root` азинқәа иҭаху — `sudo` ала инагӡа. | | `set-password` / `admin-password` | Аладатә админ апароль аиҿкаара/аԥхьаӡара (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Control-plane анашьамҭақәа БД аҟны аԥхьара/аҩра — CLI аҟынтә Анашьамҭа-каталог амаҭәахәқәа абас ишьоуп, `gateway.env` аԥсахлара. | | `license {keygen\|sign\|show <token>}` | Алицензиақәа рынапхгара: акалит ашьҭыхра, анапаҵаҩра, иарбоу токен адекодҟаҵареи агәаҭареи. | | `loadtest` | Агейтуэй иадгыланы алагатә тест анагӡара. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Аплагин SDK: ашаблон, агәаҭара, акалитқәа, апакет, анапаҵаҩра насгьы акьыԥхьра (private/public). | | `version` | Аверсиа акьыԥхьра. | | `help` | Ацхыраара аарԥшра. | ### `uninstall` флагқәа | Флаг | Аус | |---|---| | `--purge` | Адырраҭарагьы аныхра (иалкаау аныхра). | | `--yes` | Аиҿырԥшра адҵара амырмашәара. | | `--no-backup` | Аныхрахьы ахьчагатә ахымҵара. | | `--backup-dir <dir>` | Аныхрахьтәи ахьчагатә абри акаталог ахь анҵара. | ## Ахархәара алкаақәа ### Аинсталли аанагареи Аинсталл шәахаҭалатә кабинет аҟынтәи хаҭалатә инсталл линк ала ишьоуп (шәахәаԥш [Аинсталл](/ab/v1.0/getting-started/installation)); убри ашьҭахь CLI амаҵзура иаиҿкаауеит насгьы игәаҭоит: ```bash sudo aihummer up aihummer status ``` ### Аиҭагара ```bash # Иҿыц арелиз ыҟоума акәзар ршьҭра мацара aihummer update --check # Аиҭагара ахархәара sudo aihummer update ``` ### Амаҵзура анапхгареи алогқәеи Акомандақәа акны иамоу агейтуэй systemd-аиԥшра ахь ишьоит (`AIHUMMER_SERVICE`, хықәкулатәи `aihummer-gateway`); `logs` дарбанзаалак systemd-аиԥшра ахьӡ иааныркылоит. ```bash sudo aihummer restart aihummer logs # агейтуэй аиԥшра ажурнал (хықәкулатәи) aihummer logs aihummer-stt # даҽа systemd-аиԥшрак ажурнал sudo aihummer stop ``` ### Адиагностика ```bash aihummer doctor ``` ### Ахьчагатә насгьы аиҭашьақәыргылара `backup` PostgreSQL аҭагылазаашьа-хаҿы `pg_dump` ала афаил ахь ишьоит; `restore` убри адамп-афаил иԥхьоит. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres ауп ииашоу адырра ахагьежь, аха шәара шәара > `AIHUMMER_MASTER_KEY` насгьы блоб-акаталог хазы ихьчатәуп — > амастер-калит ада, ишифрхоу асекретқәа реиҭашьақәыргылара ауам. ### Админ апароль аиҿкаара Акоманда иаԥхьалоит `[--login admin] [--password X]` насгьы иазҭаху `AIHUMMER_DATABASE_URL` — иалкаау `gateway.env` аҟынтә иргылоуп, аинсталл-ахархәаҩ ихьӡала ма `sudo` ала иусура анеиуа. ```bash sudo aihummer set-password --login admin ``` ### Control-plane анашьамҭақәа `settings` БД аҟны Анашьамҭа-каталог амаҭәахәқәа аԥхьоит насгьы иҩуеит еиҭак-акгьы ада — web-админ UI (Анапхгара → Анашьамҭақәа) иԥсахуа хранилище ҩыза. Абас ауп каталог амаҭәахәқәа CLI аҟынтә ишьоу: урҭ рзы `gateway.env` аҵакы иԥхьаӡахом. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` иаанарԥшуеит ахархәаҩ-азы иарбоу каталог-акалитқәа мацара (асистематә насгьы аҩныҟатәи акалитқәа ирыхкуп); акалит зегьы имоуп иахьынтәи иарбоу тег — `[db]` шәара ишьҭыз аҵакы азы, `[unset]` каталог-хықәкулатәи аҵакы амоу азы. ### Алицензиақәа `license show` иазҭаху `<token>` аргумент насгьы `AIHUMMER_LICENSE_PUBKEY` environment аҽеиҭакра: акоманда **иарбоу** токен адекодҟаҵареи агәаҭареи ҟанаҵоит — инстанс иуажәтәи алицензиа аарԥшуам. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Алагатә тест ```bash aihummer loadtest ``` ### Аплагинқәа ```bash aihummer plugin init <kind> # манифест ашаблон (connector|service|openapi|mcp) aihummer plugin validate manifest.json # манифест аконтракт инақәыршәаны агәаҭара aihummer plugin keygen # ed25519 автор акалит (.key + .pub) aihummer plugin package ./my-plugin # тарбол + .sha256 аргылара aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Акьыԥхьра: хатәла (шәинстанс ахь) ма зегьырзы (PR каталог ахь) 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 насгьы акьыԥхьра арежим ҩбагьы азы шәахәаԥш [Аплагин SDK](/ab/v1.0/marketplace/sdk) насгьы [Аплагин акьыԥхьра](/ab/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` иазҭаху root: `sudo aihummer uninstall` инагӡа. Насгьы > `sudo aihummer uninstall --purge --yes` адырраҭара иныхуеит насгьы > аиҿырԥшра адҵара имариашәуеит — раԥхьа шәара шәыгәаҭоу ахьчагатә > шәымазаара шәыдырҳәала. ## Environment `aihummer` амаҭәахәы иԥхьо аҽеиҭакрақәа: | Аҽеиҭакра | Иарбан | |---|---| | `AIHUMMER_SERVICE` | Агейтуэй systemd-аиԥшра ахьӡ (хықәкулатәи `aihummer-gateway`) — `up`/`restart`/`stop`/`logs` рхықәкы. | | `AIHUMMER_GATEWAY_URL` | `status`/`doctor`/`loadtest` рзы агейтуэй URL (хықәкулатәи `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — `backup`/`restore`/`set-password`/`settings` рзы иазҭаху. | | `AIHUMMER_REPO` | `update` азы арелиз-репозиториа (fallback, `AIHUMMER_DOWNLOAD_BASE_URL` CDN ишьҭам акәзар). | Акомандақәа реиҳараӡак иазҭаху root (`systemctl`) — `sudo` ала инагӡа. ## Уаҩ узаауеи - Инстанс аиҿартәара: [Environment аҽеиҭакрақәа](/ab/v1.0/reference/env-vars). - Агент иахьаԥшуа амаҭәахәқәа алхра: [Амаҭәахәқәа ркаталог](/ab/v1.0/reference/tools-catalog).