Зменныя асяроддзя
AiHummer наладжваецца праз зменныя асяроддзя AIHUMMER_* (плюс некалькі
спецыфічных для інструментаў, такіх як SEARXNG_URL). Гэтая старонка — каталог,
згрупаваны па абласцях. Большасць зменных таксама рэдагуюцца з вэб-адмін-інтэрфейса.
Мадэль канфігурацыі
Кожная налада вызначаецца ў фіксаваным парадку:
database value → environment variable → built-in defaultГэта значыць, што значэнне, захаванае ў адмін-інтэрфейсе (захаванае ў базе даных),
перавызначае асяроддзе, якое перавызначае ўбудаванае значэнне па змаўчанні.
Bootstrap-зменныя — тыя, што патрэбны шлюзу, перш чым ён зможа прачытаць базу
даных, такія як AIHUMMER_DATABASE_URL і AIHUMMER_MASTER_KEY — застаюцца
толькі ў асяроддзі.
Канфігурацыйны файл для host-native усталявання знаходзіцца ў:
# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes[!TIP] Наладжвальныя, не-bootstrap ручкі лепш за ўсё змяняць у вэб-адмін-інтэрфейсе, каб яны ўступілі ў сілу без рэдагавання файлаў. Некаторыя змены (такія як пераключэнні інструментаў і глыбіня суб-агентаў) прымяняюцца гарача; іншыя патрабуюць перазапуску сэрвісу.
Ядро і база даных
| Variable | Purpose |
|---|---|
AIHUMMER_DATABASE_URL |
Абавязкова. Postgres DSN. Без яе шлюз працуе ў рэжыме толькі здароўя. |
AIHUMMER_DB_APP_URL |
DSN абмежаванай ролі, што актывуе Row-Level Security (усталёўваецца аўтаматычна для лакальных усталяванняў). |
AIHUMMER_GATEWAY_ADDR |
Адрас праслухоўвання (па змаўчанні :8780; усталявальнік выбірае вольны порт). |
AIHUMMER_DEFAULT_WORKSPACE_ID |
Уключае ўваходны дыспетчар і прастору па змаўчанні для віджэта. |
AIHUMMER_BLOB_DIR |
Уключае сэрвіс медыя/файлаў (дырэкторыя blob-сховішча). |
AIHUMMER_ADMIN_UI_DIR |
Абслугоўвае адмін-SPA па /admin/. |
AIHUMMER_WIDGET_DIR |
Абслугоўвае вэб-віджэт па /widget/. |
Бяспека і vault
| Variable | Purpose |
|---|---|
AIHUMMER_MASTER_KEY |
base64-закадаваныя 32 байты; уключае сакрэты-у-спакоі, vault і BYOK. |
AIHUMMER_MEDIA_TOKEN_SECRET |
Захоўвае падпісаныя URL спампоўкі дзеючымі праз перазапускі. |
AIHUMMER_APPROVAL_TOOLS |
Інструменты, якія патрабуюць зацвярджэння чалавекам перад запускам. |
AIHUMMER_AIRGAPPED |
1 блакіруе кантраляваны мадэллю публічны выхад (рэжым air-gapped). |
AIHUMMER_AUDIT_RETENTION_DAYS |
Акно захоўвання для адмін-аўдыт-лога. |
Аўтэнтыфікацыя і SSO
| Variable | Purpose |
|---|---|
AIHUMMER_OIDC_ISSUER |
Абараняе /v1/admin/*. Без яго (і без LDAP/SAML) адмін давярае dev-загалоўкам — ніколі не выстаўляйце такі інстанс. |
LDAP/AD і SAML наладжваюцца разам з OIDC для карпаратыўнага ўваходу; SCIM забяспечвае аўтаматычнае правіжанінг карыстальнікаў. Гл. Webhooks, SCIM і спалучэнне.
Каналы і ўваходныя
| Variable | Purpose |
|---|---|
AIHUMMER_INBOUND_SECRET |
Агульны сакрэт HMAC для выклікаў канектар → шлюз /v1/inbound/*. |
AIHUMMER_INBOUND_URL |
На баку канектара: уваходны URL шлюза, на які канектар адпраўляе. |
LLM і мадэлі
| Variable | Purpose |
|---|---|
AIHUMMER_LLM_PROVIDER |
Правайдар мадэлі для выкарыстання. |
AIHUMMER_LLM_MODEL |
Назва мадэлі. |
AIHUMMER_LLM_GATEWAY_URL |
Эндпойнт для OpenAI-сумяшчальнага LLM-шлюза. |
AIHUMMER_OPENAI_API_KEY |
API-ключ для OpenAI-сумяшчальнага правайдара. |
AIHUMMER_SUBAGENT_MAX_DEPTH |
Максімальная глыбіня спароджаных суб-агентаў. |
[!NOTE] Калі мадэль не падключана, шлюз вяртаецца да дэтэрмінаванага mock, каб сістэма ўсё роўна працавала. Платны API мадэлі ніколі не патрабуецца — бясплатныя/ лакальныя мадэлі і транспарт Codex/ChatGPT-падпіскі з’яўляюцца першакласнымі.
Інструменты
| Variable | Purpose |
|---|---|
SEARXNG_URL |
Уключае інструмент web_search (URL інстанса SearXNG). |
CLOAKBROWSER_CDP_URL |
Уключае інструменты browser/computer (URL Chrome DevTools Protocol). |
AIHUMMER_FS_ROOT |
Уключае filesystem_read, ізалявана пад гэтым каранём. |
AIHUMMER_DB_QUERY_DSN |
Уключае db_query (толькі для чытання) супраць гэтай DSN. |
AIHUMMER_CODE_EXEC |
Пераключае інструмент code_exec (выключаны па змаўчанні на агульных хостах). |
Гл. поўны Каталог інструментаў, каб даведацца, што робіць кожны інструмент.
Голас і sidecar’ы
| Variable | Purpose |
|---|---|
AIHUMMER_STT_URL |
URL sidecar маўлення-ў-тэкст (усталёўваецца аўтаматычна ўсталявальнікам). |
AIHUMMER_TTS_URL |
URL sidecar тэксту-у-маўленне (усталёўваецца аўтаматычна ўсталявальнікам). |
AIHUMMER_DIARIZE_URL |
URL sidecar дыярызацыі дыктараў. |
AIHUMMER_VOICECLONE_URL |
URL sidecar кланавання голасу. |
AIHUMMER_VIDEO_URL |
URL sidecar разумення відэа. |
Sidecar’ы — гэта асобныя HTTP-сэрвісы; шлюз дасягае іх па URL.
Вектары і эмбедынгі
| Variable | Purpose |
|---|---|
AIHUMMER_QDRANT_URL |
Сапраўднае вектарнае сховішча (Qdrant). Адсутнічае → сховішча ў памяці. |
AIHUMMER_EMBEDDER_URL |
Сапраўдны сэрвіс эмбедынгаў. Адсутнічае → hash-эмбедэр. |
Шына і назіральнасць
| Variable | Purpose |
|---|---|
AIHUMMER_NATS_URL |
Апцыянальная шына NATS для дастаўкі. |
AIHUMMER_OTEL_ENDPOINT |
OTLP-эндпойнт для push трасіровак/метрык. |
[!WARNING] Назіральнасць — толькі OTLP push. AiHummer не выстаўляе эндпойнт Prometheus
/metricsці/debug/pprof. НакіроўвайцеAIHUMMER_OTEL_ENDPOINTна ваш калектар замест гэтага.
Абнаўленні
| Variable | Purpose |
|---|---|
AIHUMMER_DOWNLOAD_BASE_URL |
Базавы URL для рэлізных артэфактаў (крыніца самаабнаўлення). |
AIHUMMER_UPDATE_CHANNEL |
Рэлізны канал для адсочвання. |
AIHUMMER_AUTO_UPDATE |
Рэжым абнаўлення: off, check ці apply. |
Усталявальныя каналы з ключавым доступам (alfa/beta/dev) дадаткова чытаюць
AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN падчас усталявання.
Маркетплэйс і плагіны
| Variable | Purpose |
|---|---|
AIHUMMER_BLOB_DIR |
Дырэкторыя blob-сховішча. Акрамя медыя/файлаў, яна захоўвае прыватныя (side-loaded) артэфакты плагінаў пад спасылкамі blob:, якія дэплоер вырашае. |
AIHUMMER_PLUGIN_PUBKEY |
Дадатковы давераны публічны ключ (base64 ed25519) для праверкі подпісаў плагінаў — у дадатак да ключа рэестра, замацаванага ў ядры. |
AIHUMMER_PLUGIN_DEV_UNSIGNED |
1 дазваляе ўсталяванне непадпісаных плагінаў. Толькі лакальная распрацоўка — ніколі на інстансе, дасягальным звонку. |
Мадэль даверу (афіцыйны → замацаваны ключ, прыватны → trust store, непадпісаны → заблакаваны) апісана ў Усталяванне і абнаўленні.
Пратакольныя паверхні (opt-in)
| Variable | Purpose |
|---|---|
AIHUMMER_MCP_PUBLISH |
1 уключае знешні MCP-сервер па POST /v1/mcp. |
AIHUMMER_A2A_PUBLISH |
1 уключае паверхню A2A (/.well-known/agent.json, /a2a/message). |
Куды далей
- Паглядзіце, якія інструменты разблакоўвае кожная зменная: Каталог інструментаў.
- Кіруйце інстансам штодня: Даведнік CLI.