Асреда аҽеишьахалатәқәа — AiHummer Адокументациа

AiHummer иаиҿкаауп AIHUMMER_* асреда аҽеишьахалатәқәа рыла (насгьы маҷ-маҷ амаҭәахә-зхаразу рацәахар, иаҳҳәап SEARXNG_URL). Абри адаҟьа акаталогуп, аган ала иеиҿкаау. Аҽеишьахалатәқәа реиҳараҩык веб-админ UI аҟынгьы иаԥсахтәуп.

Аиҿкаара амодель

Аиҿкаара зегьы ишьақәырҕәҕәоуп иҟоу аиҿкаашьа ала:

адырра аҵаакыра  →  асреда аҽеишьахалатә  →  ианагалоу анырҟәшә

Уи аанагоит админ UI аҟны еиқәырхоу адырра (адырра аҵаакыра иаҵанакуа) ианиаԥсахуа асреда, уи иаԥсахуеит ианагалоу анырҟәшә. Бутстрап аҽеишьахалатәқәа — агейтуеи адырра аҵаакыра аԥхьара алшаанӡа иҭахуа, иаҳҳәап AIHUMMER_DATABASE_URL насгьы AIHUMMER_MASTER_KEY — иаанхоит асреда мацара.

Host-native аиҿкааразы аиҿкаара афаил абра иҟоуп:

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

[!TIP] Иеиҭакхо, бутстрап-мап анырҟәшәқәа еиӷьуп веб-админ UI аҟны рыԥсахра, убри аҟынтә урҭ афаилқәа рыԥсахра ада ауснагӡатә роуеит. Аԥсахрақәак (иаҳҳәап амаҭәахә аиалкаарақәеи асаб-агент аҵаулареи) аарла рымҩаԥысуеит; даҽакқәа амаҵзура аиҭадәықылара иаҭахуп.

Ахадаратәи адырра аҵаакыреи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_DATABASE_URL`	Иаҭахуп. Postgres DSN. Уи ада агейтуеи имҩаԥысуеит агәабзиара мацара арежим аҟны.
`AIHUMMER_DB_APP_URL`	Иаԥкны-ролтә DSN, Row-Level Security иаактиву (аладатә аиҿкаарақәа рзы автоматла иҟалоит).
`AIHUMMER_GATEWAY_ADDR`	Аҭаҩра адрес (анырҟәшә `:8780`; аинсталиатор иалихуеит ихаҵахьоу порт).
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Иаактивуеит аиҭаҩратә диспетчереи виджет анырҟәшә аусуратә ҭыԥ.
`AIHUMMER_BLOB_DIR`	Иаактивуеит амедиа/афаил амаҵзура (блоб аиқәырхара акаталог).
`AIHUMMER_ADMIN_UI_DIR`	`/admin/` аҟны админ SPA аусура.
`AIHUMMER_WIDGET_DIR`	`/widget/` аҟны веб-виджет аусура.

Ашәарҭадареи асейфи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_MASTER_KEY`	base64 ала иуҩу 32 байт; иаактивуеит секретқәа-аанхара, асейфи BYOK.
`AIHUMMER_MEDIA_TOKEN_SECRET`	Инапаҵаҩу аҭагаратә URL аиҭадәықыларақәа рыбжьара иеиҿкааны иаанхоит.
`AIHUMMER_APPROVAL_TOOLS`	Имҩаԥысаанӡа ауаҩытәы-аусура-зыцу аиашьахалара зҭаху амаҭәахәқәа.
`AIHUMMER_AIRGAPPED`	`1` иаанкылоит модельла-инапхгоу зегьырзы иаарту аҭагара (air-gapped режим).
`AIHUMMER_AUDIT_RETENTION_DAYS`	Админ аудит алог азы ааныжьра аамҭа.

Аидентификациеи SSO-и

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_OIDC_ISSUER`	Иахьчоит `/v1/admin/*`. Уи ада (насгьы LDAP/SAML ада) админ агәрагоит дев-загьаҩақәа — мап аиҿкаара аарԥшра.

LDAP/AD насгьы SAML иеиҿкаауп OIDC ацҵаны кәырпороциатә ҭалара азы; SCIM иаулоит автоматла аусуҩ аиҿкаара. Шәахәаԥш Вебхукқәа, SCIM насгьы аидҟьара.

Аканалқәеи аиҭаҩреи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_INBOUND_SECRET`	HMAC еицырзеиԥшу асекрет коннектор → гейтуеи `/v1/inbound/*` ааԥхьарақәа рзы.
`AIHUMMER_INBOUND_URL`	Коннектор аган ала: коннектор иахьаԥшна агейтуеи аиҭаҩратә URL.

LLM-и амоделқәеи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_LLM_PROVIDER`	Иахархәахо амодель апровайдер.
`AIHUMMER_LLM_MODEL`	Амодель ахьӡ.
`AIHUMMER_LLM_GATEWAY_URL`	OpenAI инақәыршәоу LLM гейтуеи азы аҭыԥ.
`AIHUMMER_OPENAI_API_KEY`	OpenAI инақәыршәоу апровайдер азы API калит.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Иадәылҵыз асаб-агентқәа рыҵаулара аизах.

[!NOTE] Амодель аныжьымкәа ианыҟоу агейтуеи иҭалоит детерминланы имоктә ахь, убри аҟынтә асистема аусура иацырҵоит. Ахәы зну амодель API анысаҟара аҭахым — хаҭагьы/аладатә амоделқәеи Codex/ChatGPT-абонементтә транспорти раԥхьатәи аклас рҟоуп.

Амаҭәахәқәа

Аҽеишьахалатә	Ахықәкы
`SEARXNG_URL`	Иаактивуеит `web_search` амаҭәахә (SearXNG инстанс URL).
`CLOAKBROWSER_CDP_URL`	Иаактивуеит `browser`/`computer` амаҭәахәқәа (Chrome DevTools Protocol URL).
`AIHUMMER_FS_ROOT`	Иаактивуеит `filesystem_read`, абри арыцә алада исандбоксу.
`AIHUMMER_DB_QUERY_DSN`	Иаактивуеит `db_query` (аԥхьара мацара) абри DSN иадгыланы.
`AIHUMMER_CODE_EXEC`	Иаиалкаауеит `code_exec` амаҭәахә (еицырзеиԥшу ахостқәа рҟны анырҟәшә ала иаанкылоуп).

Иарбан амаҭәахә иҟанаҵо иазны шәахәаԥш Амаҭәахәқәа ркаталог.

Абжьыи асайдкарқәеи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_STT_URL`	Ажәахә-ала-атекст сайдкар URL (аинсталиатор автоматла иарбоит).
`AIHUMMER_TTS_URL`	Атекст-ала-ажәахә сайдкар URL (аинсталиатор автоматла иарбоит).
`AIHUMMER_DIARIZE_URL`	Абжьыҟазҵаҩы аиҟәшара сайдкар URL.
`AIHUMMER_VOICECLONE_URL`	Абжьы аклонра сайдкар URL.
`AIHUMMER_VIDEO_URL`	Авидео аилкаара сайдкар URL.

Асайдкарқәа хазы иҟоу HTTP амаҵзурақәоуп; агейтуеи URL ала иаанахаоит.

Авекторқәеи аумбеддингқәеи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_QDRANT_URL`	Иҵабыргу авектортә аиқәырхара (Qdrant). Анымҟа → агәаҭарахьтәи аиқәырхара.
`AIHUMMER_EMBEDDER_URL`	Иҵабыргу аумбеддер амаҵзура. Анымҟа → хеш-аумбеддер.

Абуси агәаҭареи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_NATS_URL`	Иалкаахо NATS бус анашьҭразы.
`AIHUMMER_OTEL_ENDPOINT`	OTLP эндпоинт атрасса/аметрика арышьҭразы.

[!WARNING] Агәаҭара OTLP арышьҭра мацара ауп. AiHummer иаанмыԥшуам Prometheus /metrics эндпоинт ма /debug/pprof. AIHUMMER_OTEL_ENDPOINT шәара шәколлектор ахь шәархьба.

Аҿыцрақәа

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_DOWNLOAD_BASE_URL`	Аиҭагара артефактқәа рзы база URL (хаҿыцратә ҵаакыра).
`AIHUMMER_UPDATE_CHANNEL`	Иахьаԥшна аиҭагара аканал.
`AIHUMMER_AUTO_UPDATE`	Аҿыцра режим: `off`, `check` ма `apply`.

Калитла-иаанкылоу аиҿкаара аканалқәа (alfa/beta/dev) ацҵаны ирԥхьоит AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN аиҿкаара аамҭазы.

Амаркетплейси аплагинқәеи

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_BLOB_DIR`	Блоб-аиқәырхара акаталог. Амедиа/афаилқәа рыцҵаны, иаиқәнархоит хатәтә (хазы-иаагалоу) аплагин артефактқәа `blob:` рефқәа рыла, адеплоиер изыӡбо.
`AIHUMMER_PLUGIN_PUBKEY`	Иацу игәырҕьоу зегьырзы иаарту акалит (base64 ed25519) аплагин анапаҵаҩрақәа ргәаҭаразы — ацҵаны ядро аҟны иаамхоу арегистри акалит.
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` иаалоит инапаҵамҩу аплагинқәа риҿкаара. Аладатә argylara мацара — иҭагмыжьу инстанс аҟны мап.

Агәрагара амодель (официал → иаамхоу акалит, хатәтә → агәрагара аиқәырхара, инапаҵамҩу → иаанкылоу) аарԥшуп Аиҿкаареи аҿыцрақәеи аҟны.

Апротокол аганқәа (опт-ин)

Аҽеишьахалатә	Ахықәкы
`AIHUMMER_MCP_PUBLISH`	`1` иаактивуеит адәахьтәи MCP сервер `POST /v1/mcp` аҟны.
`AIHUMMER_A2A_PUBLISH`	`1` иаактивуеит A2A аган (`/.well-known/agent.json`, `/a2a/message`).

Анаҟара ахь

Иарбан амаҭәахәқәа аҽеишьахалатә иаалырҟьо: Амаҭәахәқәа ркаталог.
Инстанс мшыла-мшыла анапхгара: CLI ахԥхьаӡара.