Muhit oʻzgaruvchilari — AiHummer Hujjatlar

AiHummer AIHUMMER_* muhit oʻzgaruvchilari orqali (hamda SEARXNG_URL kabi bir nechta asbobga xos oʻzgaruvchilar bilan) sozlanadi. Bu sahifa — sohalar boʻyicha guruhlangan katalog. Koʻpgina oʻzgaruvchilarni veb admin UI’dan ham tahrirlash mumkin.

Konfiguratsiya modeli

Har bir sozlama belgilangan tartibda aniqlanadi:

database value  →  environment variable  →  built-in default

Bu shuni anglatadiki, admin UI’da saqlangan qiymat (maʼlumotlar bazasida saqlanadi) muhitdan ustun turadi, u esa oʻrnatilgan standart qiymatdan ustun turadi. Bootstrap oʻzgaruvchilari — gateway maʼlumotlar bazasini oʻqishidan oldin kerak boʻladiganlar, masalan AIHUMMER_DATABASE_URL va AIHUMMER_MASTER_KEY — faqat muhitda qoladi.

Host-native oʻrnatish uchun konfiguratsiya fayli quyidagi joyda joylashgan:

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

[!TIP] Sozlanadigan, bootstrap boʻlmagan tugmachalarni veb admin UI’da oʻzgartirish eng yaxshisi, shunda ular fayllarni tahrirlamasdan kuchga kiradi. Baʼzi oʻzgarishlar (masalan, asbob tugmachalari va sub-agent chuqurligi) issiq (hot) qoʻllanadi; boshqalari xizmatni qayta ishga tushirishni talab qiladi.

Core va maʼlumotlar bazasi

Oʻzgaruvchi	Maqsadi
`AIHUMMER_DATABASE_URL`	Talab qilinadi. Postgres DSN. Usiz gateway faqat sogʻliq rejimida ishlaydi.
`AIHUMMER_DB_APP_URL`	Row-Level Security’ni faollashtiradigan cheklangan rolli DSN (mahalliy oʻrnatishlar uchun avtomatik oʻrnatiladi).
`AIHUMMER_GATEWAY_ADDR`	Tinglash manzili (standart `:8780`; oʻrnatuvchi boʻsh portni tanlaydi).
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Kiruvchi dispetcherni va vidjetning standart ish maydonini yoqadi.
`AIHUMMER_BLOB_DIR`	Media/fayl xizmatini yoqadi (blob saqlash katalogi).
`AIHUMMER_ADMIN_UI_DIR`	Admin SPA’ni `/admin/` da xizmat qiladi.
`AIHUMMER_WIDGET_DIR`	Veb vidjetni `/widget/` da xizmat qiladi.

Xavfsizlik va vault

Oʻzgaruvchi	Maqsadi
`AIHUMMER_MASTER_KEY`	base64 bilan kodlangan 32 bayt; sirlarni saqlashda shifrlash, vault va BYOK’ni yoqadi.
`AIHUMMER_MEDIA_TOKEN_SECRET`	Qayta ishga tushirishlar davomida imzolangan yuklab olish URL’larini amal qilishini saqlaydi.
`AIHUMMER_APPROVAL_TOOLS`	Ishga tushishidan oldin inson tasdigʻini (human-in-the-loop) talab qiladigan asboblar.
`AIHUMMER_AIRGAPPED`	`1` model boshqaradigan ommaviy chiquvchi trafikni bloklaydi (air-gapped rejim).
`AIHUMMER_AUDIT_RETENTION_DAYS`	Admin audit logi uchun saqlash oynasi.

Autentifikatsiya va SSO

Oʻzgaruvchi	Maqsadi
`AIHUMMER_OIDC_ISSUER`	`/v1/admin/*` ni himoya qiladi. Usiz (va LDAP/SAML’siz) admin dev sarlavhalariga ishonadi — bunday nusxani hech qachon ochmang.

LDAP/AD va SAML korporativ kirish uchun OIDC bilan birga sozlanadi; SCIM foydalanuvchilarni avtomatik taʼminlashni taʼminlaydi. Qarang Webhook’lar, SCIM va juftlash.

Kanallar va kiruvchi

Oʻzgaruvchi	Maqsadi
`AIHUMMER_INBOUND_SECRET`	Konnektor → gateway `/v1/inbound/*` chaqiruvlari uchun HMAC umumiy siri.
`AIHUMMER_INBOUND_URL`	Konnektor tomonida: konnektor post qiladigan gateway kiruvchi URL.

LLM va modellar

Oʻzgaruvchi	Maqsadi
`AIHUMMER_LLM_PROVIDER`	Foydalaniladigan model provayderi.
`AIHUMMER_LLM_MODEL`	Model nomi.
`AIHUMMER_LLM_GATEWAY_URL`	OpenAI bilan mos LLM gateway uchun endpoint.
`AIHUMMER_OPENAI_API_KEY`	OpenAI bilan mos provayder uchun API kaliti.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Ishga tushirilgan sub-agentlarning maksimal chuqurligi.

[!NOTE] Agar hech qanday model ulanmagan boʻlsa, gateway deterministik mock’ga qaytadi, shunda tizim baribir ishlaydi. Hech qachon pulli model API talab qilinmaydi — bepul/mahalliy modellar va Codex/ChatGPT-obuna transporti birinchi darajali.

Asboblar

Oʻzgaruvchi	Maqsadi
`SEARXNG_URL`	`web_search` asbobini yoqadi (SearXNG nusxa URL’i).
`CLOAKBROWSER_CDP_URL`	`browser`/`computer` asboblarini yoqadi (Chrome DevTools Protocol URL’i).
`AIHUMMER_FS_ROOT`	Ushbu ildiz ostida qum qutisidagi `filesystem_read`’ni yoqadi.
`AIHUMMER_DB_QUERY_DSN`	Ushbu DSN’ga qarshi `db_query` (faqat oʻqish)’ni yoqadi.
`AIHUMMER_CODE_EXEC`	`code_exec` asbobini almashtiradi (umumiy host’larda standart holatda oʻchirilgan).

Har bir asbob nima qilishini bilish uchun toʻliq Asboblar katalogi’ga qarang.

Ovoz va sidecar’lar

Oʻzgaruvchi	Maqsadi
`AIHUMMER_STT_URL`	Nutqni-matnga sidecar URL’i (oʻrnatuvchi tomonidan avtomatik oʻrnatiladi).
`AIHUMMER_TTS_URL`	Matnni-nutqqa sidecar URL’i (oʻrnatuvchi tomonidan avtomatik oʻrnatiladi).
`AIHUMMER_DIARIZE_URL`	Speaker-diarizatsiya sidecar URL’i.
`AIHUMMER_VOICECLONE_URL`	Ovoz-klonlash sidecar URL’i.
`AIHUMMER_VIDEO_URL`	Video-tushunish sidecar URL’i.

Sidecar’lar — alohida HTTP xizmatlari; gateway ularga URL orqali yetadi.

Vektorlar va embeddinglar

Oʻzgaruvchi	Maqsadi
`AIHUMMER_QDRANT_URL`	Haqiqiy vektor ombori (Qdrant). Yoʻq → xotiradagi ombor.
`AIHUMMER_EMBEDDER_URL`	Haqiqiy embedder xizmati. Yoʻq → hash embedder.

Bus va kuzatuvchanlik

Oʻzgaruvchi	Maqsadi
`AIHUMMER_NATS_URL`	Yetkazib berish uchun ixtiyoriy NATS bus.
`AIHUMMER_OTEL_ENDPOINT`	Iz/metrikalarni yuborish uchun OTLP endpoint.

[!WARNING] Kuzatuvchanlik faqat OTLP push orqali. AiHummer Prometheus /metrics endpoint’ini yoki /debug/pprof’ni ochmaydi. Buning oʻrniga AIHUMMER_OTEL_ENDPOINT’ni kollektoringizga yoʻnaltiring.

Yangilanishlar

Oʻzgaruvchi	Maqsadi
`AIHUMMER_DOWNLOAD_BASE_URL`	Reliz artefaktlari uchun asosiy URL (oʻz-oʻzini yangilash manbai).
`AIHUMMER_UPDATE_CHANNEL`	Kuzatiladigan reliz kanali.
`AIHUMMER_AUTO_UPDATE`	Yangilash rejimi: `off`, `check` yoki `apply`.

Kalit bilan himoyalangan oʻrnatish kanallari (alfa/beta/dev) qoʻshimcha ravishda oʻrnatish vaqtida AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN’ni oʻqiydi.

Marketpleys va plaginlar

Oʻzgaruvchi	Maqsadi
`AIHUMMER_BLOB_DIR`	Blob-saqlash katalogi. Media/fayllardan tashqari, u deployer hal qiladigan `blob:` havolalari ostida xususiy (side-loaded) plagin artefaktlari’ni saqlaydi.
`AIHUMMER_PLUGIN_PUBKEY`	Plagin imzolarini tekshirish uchun qoʻshimcha ishonchli ochiq kalit (base64 ed25519) — core’da pinlangan registr kalitiga qoʻshimcha ravishda.
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` imzosiz plaginlarni oʻrnatishga ruxsat beradi. Faqat mahalliy ishlab chiqish uchun — tashqaridan kirish mumkin boʻlgan nusxada hech qachon.

Ishonch modeli (rasmiy → pinlangan kalit, xususiy → ishonch ombori, imzosiz → bloklangan) Oʻrnatish va yangilanishlar’da tasvirlangan.

Protokol yuzalari (opt-in)

Oʻzgaruvchi	Maqsadi
`AIHUMMER_MCP_PUBLISH`	`1` `POST /v1/mcp` da tashqi MCP serverini yoqadi.
`AIHUMMER_A2A_PUBLISH`	`1` A2A yuzasini (`/.well-known/agent.json`, `/a2a/message`) yoqadi.

Keyingisi qayerda

Har bir oʻzgaruvchi qaysi asboblarni ochishini koʻring: Asboblar katalogi.
Nusxani kundan-kunga boshqaring: CLI maʼlumotnomasi.