Daşky gurşaw üýtgeýjileri — AiHummer Resminamalar

AiHummer AIHUMMER_* daşky gurşaw üýtgeýjileri arkaly sazlanýar (we SEARXNG_URL ýaly birnäçe gural-ýörite üýtgeýji bilen). Bu sahypa ugur boýunça toparlara bölünen katalogdyr. Üýtgeýjileriň köpüsi web admin UI-den hem redaktirlenip bilner.

Sazlama modeli

Her sazlama berk tertipde çözülýär:

database value  →  environment variable  →  built-in default

Bu, admin UI-de saklanan bahanyň (maglumat bazasynda saklanan) daşky gurşawy basyp geçýändigini, ol bolsa içki deslapky bahany basyp geçýändigini aňladýar. Bootstrap üýtgeýjileri — gateway maglumat bazasyny okap bilmezinden öň gerek bolanlar, mysal üçin AIHUMMER_DATABASE_URL we AIHUMMER_MASTER_KEY — diňe-daşky-gurşaw bolup galýar.

Host-natiwe gurnama üçin sazlama faýly şu ýerde ýerleşýär:

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

[!TIP] Sazlanyp bilinýän, bootstrap däl düwmeler iň gowusy web admin UI-de üýtgedilýär, şonuň üçin olar faýllary redaktirlemezden güýje girýär. Käbir üýtgeşmeler (mysal üçin gural açyşlary we sub-agent çuňlugy) gyzgyn ulanylýar; beýlekiler hyzmaty gaýtadan başlatmagy talap edýär.

Core we maglumat bazasy

Üýtgeýji	Maksat
`AIHUMMER_DATABASE_URL`	Hökmany. Postgres DSN. Onsuz gateway diňe-saglyk režiminde işleýär.
`AIHUMMER_DB_APP_URL`	Row-Level Security-ni işjeňleşdirýän çäkli-rol DSN (ýerli gurnamalar üçin awtomatiki bellenýär).
`AIHUMMER_GATEWAY_ADDR`	Diňleme salgysy (deslapky `:8780`; gurnaýjy boş port saýlaýar).
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Içerik (inbound) dispetçerini we widjetiň deslapky iş giňişligini işjeňleşdirýär.
`AIHUMMER_BLOB_DIR`	Media/faýl hyzmatyny işjeňleşdirýär (blob saklama katalogy).
`AIHUMMER_ADMIN_UI_DIR`	Admin SPA-ny `/admin/`-da hödürleýär.
`AIHUMMER_WIDGET_DIR`	Web widjetini `/widget/`-da hödürleýär.

Howpsuzlyk we seýf

Üýtgeýji	Maksat
`AIHUMMER_MASTER_KEY`	base64-kodlanan 32 baýt; syrlary-dynçda, seýfi we BYOK-y işjeňleşdirýär.
`AIHUMMER_MEDIA_TOKEN_SECRET`	Gol çekilen ýükläp alma URL-lerini gaýtadan başlamalarda dogry saklaýar.
`AIHUMMER_APPROVAL_TOOLS`	Işlemezinden öň adam-aýlawynda tassyklama talap edýän gurallar.
`AIHUMMER_AIRGAPPED`	`1` model-dolandyrylýan jemgyýetçilik daşaryk çykyşy petikleýär (air-gapped režimi).
`AIHUMMER_AUDIT_RETENTION_DAYS`	Admin audit logy üçin saklama penjiresi.

Kesgitleme we SSO

Üýtgeýji	Maksat
`AIHUMMER_OIDC_ISSUER`	`/v1/admin/*`-y goraýar. Onsuz (we LDAP/SAML-syz) admin dev başlyklaryna ynanýar — beýle instansy hiç wagt açyk goýmaň.

LDAP/AD we SAML kärhana girişi üçin OIDC bilen ýanaşyk sazlanýar; SCIM awtomatiki ulanyjy üpjün etmegi berýär. Serediň Webhook-lar, SCIM we jübütleme.

Kanallar we içerik (inbound)

Üýtgeýji	Maksat
`AIHUMMER_INBOUND_SECRET`	Konnektor → gateway `/v1/inbound/*` jaňlary üçin HMAC paýlaşylan syr.
`AIHUMMER_INBOUND_URL`	Konnektor tarapy: konnektoryň ýerleşdirýän gateway içerik (inbound) URL-i.

LLM we modeller

Üýtgeýji	Maksat
`AIHUMMER_LLM_PROVIDER`	Ulanyljak model üpjün edijisi.
`AIHUMMER_LLM_MODEL`	Model ady.
`AIHUMMER_LLM_GATEWAY_URL`	OpenAI-laýyk LLM gateway-i üçin endpoint.
`AIHUMMER_OPENAI_API_KEY`	OpenAI-laýyk üpjün ediji üçin API açary.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Döredilen sub-agentleriň iň ýokary çuňlugy.

[!NOTE] Eger hiç model birikdirilmedik bolsa, gateway deterministik mok-a yza gaýdýar, şonuň üçin ulgam henizem işleýär. Hiç wagt töleg model API talap edilmeýär — mugt/ýerli modeller we Codex/ChatGPT-abuna transporty birinji derejelidir.

Gurallar

Üýtgeýji	Maksat
`SEARXNG_URL`	`web_search` guralyny işjeňleşdirýär (SearXNG instans URL-i).
`CLOAKBROWSER_CDP_URL`	`browser`/`computer` gurallaryny işjeňleşdirýär (Chrome DevTools Protocol URL-i).
`AIHUMMER_FS_ROOT`	`filesystem_read`-i işjeňleşdirýär, bu root astynda sandbox-laşan.
`AIHUMMER_DB_QUERY_DSN`	Bu DSN-e garşy `db_query`-ni (diňe-okamak) işjeňleşdirýär.
`AIHUMMER_CODE_EXEC`	`code_exec` guralyny açýar (paýlaşylan hostlarda deslapky ýagdaýda öçük).

Her guralyň näme edýändigi üçin doly Gurallar katalogyna serediň.

Ses we sidecar-lar

Üýtgeýji	Maksat
`AIHUMMER_STT_URL`	Sözden tekste sidecar URL-i (gurnaýjy tarapyndan awto-bellenýär).
`AIHUMMER_TTS_URL`	Tekstden söze sidecar URL-i (gurnaýjy tarapyndan awto-bellenýär).
`AIHUMMER_DIARIZE_URL`	Geplän diarizasiýasy sidecar URL-i.
`AIHUMMER_VOICECLONE_URL`	Ses klonlama sidecar URL-i.
`AIHUMMER_VIDEO_URL`	Wideo-düşünme sidecar URL-i.

Sidecar-lar aýratyn HTTP hyzmatlary; gateway olara URL arkaly ýetýär.

Wektorlar we embedding-ler

Üýtgeýji	Maksat
`AIHUMMER_QDRANT_URL`	Hakyky wektor saklama (Qdrant). Ýok → ýatda-saklama.
`AIHUMMER_EMBEDDER_URL`	Hakyky embedder hyzmaty. Ýok → hash embedder.

Awtobus we gözegçilik

Üýtgeýji	Maksat
`AIHUMMER_NATS_URL`	Eltiş üçin islege görä NATS awtobusy.
`AIHUMMER_OTEL_ENDPOINT`	Yzlar/metrikalar iberişi üçin OTLP endpoint.

[!WARNING] Gözegçilik diňe OTLP iberiş. AiHummer Prometheus /metrics endpoint-ini ýa-da /debug/pprof-y görkezmeýär. Onuň ýerine AIHUMMER_OTEL_ENDPOINT-i öz kollektoryňyza gönükdiriň.

Täzelemeler

Üýtgeýji	Maksat
`AIHUMMER_DOWNLOAD_BASE_URL`	Çykuş artefaktlary üçin baza URL (öz-täzeleme çeşmesi).
`AIHUMMER_UPDATE_CHANNEL`	Yzarlanjak çykuş kanaly.
`AIHUMMER_AUTO_UPDATE`	Täzeleme režimi: `off`, `check` ýa-da `apply`.

Açar-gabawly gurnama kanallary (alfa/beta/dev) goşmaça gurnama wagtynda AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN okaýar.

Market we plaginler

Üýtgeýji	Maksat
`AIHUMMER_BLOB_DIR`	Blob-saklama katalogy. Media/faýllardan başga, ol hususy (gapdaldan ýüklenen) plagin artefaktlaryny deployer çözýän `blob:` salgylanmalary astynda saklaýar.
`AIHUMMER_PLUGIN_PUBKEY`	Plagin gollaryny barlamak üçin goşmaça ynanylan jemgyýetçilik açary (base64 ed25519) — core-da berkidilen registr açaryna goşmaça.
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` gol çekilmedik plaginleri gurnamaga rugsat berýär. Diňe ýerli işläp düzme — hiç wagt daşardan elýeterli instansda däl.

Ynam modeli (resmi → berkidilen açar, hususy → ynam saklama, gol çekilmedik → petiklenen) Gurnama we täzelenmeler sahypasynda beýan edilýär.

Protokol üstleri (opt-in)

Üýtgeýji	Maksat
`AIHUMMER_MCP_PUBLISH`	`1` `POST /v1/mcp`-de daşky MCP serweri işjeňleşdirýär.
`AIHUMMER_A2A_PUBLISH`	`1` A2A üstüni işjeňleşdirýär (`/.well-known/agent.json`, `/a2a/message`).

Indiki nirä

Her üýtgeýjiniň haýsy gurallary açýandygyny görüň: Gurallar katalogy.
Instansy günbe-gün dolandyryň: CLI salgylanmasy.