Çevre Üzlükleri

AiHummer konfigurasiýasy bölünýär iki doly tapawutly topar:

Bootstrap (gateway.env) — portalyň nämelere bilmegi gerek ilgili ol edip bilýär maglumatlar bazasyny okla: maglumatlar bazasy DSN, diňleýiş adresleri, statik kataloglar, baş açar. Diňe bu açarlaryň ýagdaýdan okaýyş edilýär.
Sazlamalar katalogy (baza maglumatlary) — beýleki her bir düwme. Bular bu ýerde saklanýar Maglumatlar bazasy we web beýlekiniň dolandyryş interfeýsinde (Dolandyryş → Sazlamalar) ýa-da bilen aihummer settings set <KEY> <VALUE>. Munlar üçin a açarlary gateway.env bahasy biyada göz öňünde tutulman geçilen — goýulsa-da, onuň bar tä’sir etmeýär.

Konfigurasiýa modeli

gateway.env -dir diňe bootstrap. Kararyň tertibi:

Sazlamalar-katalog açary: database value → built-in default (gurşaw nazara alynmaýar);
başlatma açary: environment variable only.

Şonuň üçin sazlap bolýan düwmeler üçin birinji we ýeke dogry çeşme bazadyr (web admin UI / aihummer settings); daşky gurşaw faqat öňe gitmek üçin prosesiň zerur bolan zatlaryny özünde jemleýär.

Meýdana ýerli gurnama üçin konfigurasiýa faýly şu ýerdedir:

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

[!TIP] Sazlamalar kataloginiň düwmelerini goýma gateway.env — hiç hili täsiri ýok. Üýtget olary web administrasiýa interfeýsinde (Dolandyryş → Sazlamalar, gözleg bar) ýa-da arkaly aihummer settings set. Käbir üýtgeşmeler (gural çalyşmaklary we kömekçi-agent gendan) gyzgyn ulanyň; beýlekiler hyzmatyň täzeden başlamagyny talap edýär.

Bootstrap (gateway.env)

Gapynyň hakykatdanam öňünden alýan ýeke-täk düwmeleri.

Esasy & maglumatlar bazasy

Üýtgeýän	Maksat
`AIHUMMER_DATABASE_URL`	Talap edilýär. Postgres DSN. Munyzsyz gapy diňe saglyk režiminde işleýär.
`AIHUMMER_DB_APP_URL`	Setir derejeli Howpsuzlygy işjeňleşdirýän çäklendirilmiş-roly DSN (ýerli gurnamalar üçin awtomatiki döredilýär).
`AIHUMMER_GATEWAY_ADDR`	Ilaty diňlemegiň salgysy (çägelenen) `:8780`) — ähli daşarky traffik: API (`/v1/*`), juplamak, WS/SSE, gelýän webhukslar, programma/pyçak proksisi we saglyk barlaglary.
`AIHUMMER_WEBUI_ADDR`	Şahsy administrasiýa Web UI diňleýiş salgysy (başlangyç) `:8781`), kök ýoly boýunça hyzmat edildi `/`; iň gowy ýagdaýda diňe içki interfeýse baglanyşykly. Başla `0` öçürmek üçin.
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Saýlanan girýän integrasiýalar üçin öňünden kesgitlenen iş meýdançasyny saýlaýar.
`AIHUMMER_HOME_ROOT`	Tügeliň (adatça binar ýolyndan alnan); admin-ui/blob/installer kataloglaryny we açar faýllaryny berkidýär.
`AIHUMMER_BLOB_DIR`	Media/faýl hyzmatyny (blob saklaýyş katalogyny) işjeňleşdirýär. Ol şeýle hem saklaýar şahsy (daşardan ýüklenen) plugin öňündäki zatlar asty `blob:` deployer tarapyndan çözülen refs.
`AIHUMMER_ADMIN_UI_DIR`	Admin SPA-a hyzmat edýär `/admin/`.

Syrlar we infrastruktura

Üýtgeýän	Maksat
`AIHUMMER_MASTER_KEY`	base64-şifirlenen 32 bait; dynýan syrlary, gapyjy we BYOK-i ýola goýmagy mümkin edýär.
`AIHUMMER_MEDIA_TOKEN_SECRET`	Gol çekilen ýükläp alma URL-lerini täzeden başlamalarda hem ýerine ýetirýär.
`AIHUMMER_OTEL_ENDPOINT`	Trassalary/ölçegleri itermek üçin OTLP nokady.
`AIHUMMER_DOWNLOAD_BASE_URL`	Çykarylan artefaktlar üçin esasy URL (özüni täzelýän çeşme).

[!WARNING] Görkezilşligi Diňe OTLP itekle. AiHummer edýär däk Prometheusy açmak /metrics ahyry ýa-da /debug/pprof. Nokat AIHUMMER_OTEL_ENDPOINT seniň ýanyňda berraýynyn ýerine.

Täzelenmeler katalogy (maglumatlar bazasy — web administrasiýa interfeýsi ýa-da `aihummer settings`)

Aşakdaky her bir açar maglumatlar bazasynda saklanýar. Ony web administrasiýa ulanyjy interfeýsinde goýuň (Dolandyryş → Sazlamalar) ýa-da şeýdip:

aihummer settings set AIHUMMER_LLM_PROVIDER openai

A gateway.env şeýle açaryň gymmaty üpjün edilmän.

Howpsuzlyk

Açar	Maksat
`AIHUMMER_APPROVAL_TOOLS`	Işlemeli başlamaz öň adam gatnaşmagy bilen tassyklamany talap edýän gurallar.
`AIHUMMER_AIRGAPPED`	`1` modeliniň gözegçiligindäki jemgyýetçilik çykalmagyny (howa aralykly režim) blok edýär.
`AIHUMMER_AUDIT_RETENTION_DAYS`	Admin audit ýazgylary üçin saklamak beýikligi.
`AIHUMMER_INBOUND_SECRET`	Birikdiriji üçin HMAC paýlaşılan syr → giriş gapysy `/v1/inbound/*` jaň edýär.

Tanyşdyrma we SSO

Açar	Maksat
`AIHUMMER_OIDC_ISSUER`	Gorýar `/v1/admin/*`. Munyzsyz (we LDAP/SAML ýokasynda) admin dev başlyklaryna ynanýar — şeýle nusgany hiç haçan açma.

LDAP/AD we SAML korporatiw girmek üçin OIDC bilen bilelikde sazlanan; SCIM awtomatiki ulanyjy üpjünçiligini berýär. Garaň Webhooks, SCIM we jübütleşdirmek.

LLM we modeller

Açar	Maksat
`AIHUMMER_LLM_PROVIDER`	Ulanyljak model üpjün ediji.
`AIHUMMER_LLM_MODEL`	Modeliň ady.
`AIHUMMER_LLM_GATEWAY_URL`	OpenAI bilen utgaşykly LLM gateway/ahyrky nokatlaryň esasy URL salgysy (`AIHUMMER_LLM_*` ýoly; ýerli `AIHUMMER_OPENAI_BASE_URL`-den tapawutlanýar). BYOK we üpjün edijiler bölümine serediň.
`AIHUMMER_OPENAI_API_KEY`	OpenAI bilen gabat gelýän üpjün ediji üçin API açary.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Paýda bolan kömekçi agentleriň iň öňki çuňlugy.

[!NOTE] Eger hiç bir model baglanmadyk bolsa, gapy gaýtadan birine geçýär kesgitlenilen simulýasiýa şonuň üçin sistem henizem işleýär. Tölän model API-ä hiç haçan mätäçlik ýok — mugt/ýerli modeller we bir Codex/ChatGPT-abuna transporty birinji synpdy.

Gural

Açar	Maksat
`AIHUMMER_FS_ROOT`	Ýagdaý berýär `filesystem_read`, bu kök aşagynda sandbox edilip goýuldy.
`AIHUMMER_DB_QUERY_DSN`	Ýagdaý berýär `db_query` (diňe okalýan) bu DSN bilen öňünde.
`AIHUMMER_CODE_EXEC`	Çalşydýar `code_exec` gurnama (öçürilen) orta meşhur myhmanlarda defolt).

Web gözlegi we brauzeri gurnaýjy dolandyrýar: olar gutudan çykan badyna gurnalýar, --no-search / --no-browser bilen öçürilýär we --external-search=URL / --external-browser=URL bilen bar bolan nusga gönükdirilýär — olar üçin operator sazlamalary ýok.

Doly gözüň Gurnama katalogy her bir guralyň näme iş edýändigini.

Ses we gapylaklar

Açar	Maksat
`AIHUMMER_STT_URL`	Sözden-tekste kenar program URL-i (gurnalýan tarapyndan batyrylan).
`AIHUMMER_TTS_URL`	Gürleşikden tekste geçiren hyzmatyň URL-ü (gurnamaçy tarapyndan başlanýar).
`AIHUMMER_VIDEO_URL`	Wideo-düşünme sidekar URL-si.

Sidecarlar bölünjek HTTP hyzmatlarydyr; geçelge olara URL arkaly gelýär.

Wektorlar we embeddings

Açar	Maksat
`AIHUMMER_QDRANT_URL`	Hakyky wektor magazini (Qdrant). Yok → ýatdaky magazin.
`AIHUMMER_EMBEDDER_URL`	Hakyky embedder hyzmaty. Yok → hash embedder.

Protokol ýüzleri (özüni ýazdyrmak)

Açar	Maksat
`AIHUMMER_MCP_PUBLISH`	Takyk `1` `POST /v1/mcp` salgysynda daşarky MCP serwerini açýar. Öz-özünden hiç bir guraly eksport etmeýär.
`AIHUMMER_MCP_EXPORT_TOOLS`	MCP müşderisiniň görjek, otur bilen bölünen takyk gural atlary. Boş (adaty) = NOL gural eksport edilýär.
`AIHUMMER_A2A_PUBLISH`	`1` A2A ýüzüni işledýär (`/.well-known/agent.json`, `/a2a/message`).

Diňe Dev gurluşlary

Üýtgeýän	Maksat
`AIHUMMER_PLUGIN_PUBKEY`	Plugin gol çekmelerini barlamak üçin goşmaça ynanylýan jemgyýetçilik açary (base64 ed25519). Diňe ösüş üçin gurlýar — çykýan gurluşlarda üns berilmeýär (registr ulgamyň açary binara bölünip goýuldy).
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` gurmaga rugsat berýär imzasyz pluginler. Diňe öseniniň gurluşlary — çykarmak gurluşlarynda ignor edilýär. Daşarky elýeterli bir nusgada öň hiç haçan.

[!WARNING] Çykyş gurluşlarynda plagin ynam kökü ikiälli kodyň içine hörülip goýlan we çäklemeler ýa-da sazlamalar bilen üýtgedip bolmaz — bu üýtgemä garşy çäre kepillik.

Ýaýyn modeli (resmi → göçürilen açar, hususy → ynamly saklaýyş, gol goýulmadyk → böwetlendi) aýdylýar Gurnama we täzelenmeler.

Indi nire?

Her açaryň haýsy enjamy açýandygyny görüň: Gurnama katalogy.
Wakany gündelik işletið: CLI salgysy.