Mühit Dəyişənləri
AiHummer AIHUMMER_* mühit dəyişənləri (üstəgəl SEARXNG_URL kimi bir neçə
alətə xas dəyişən) vasitəsilə konfiqurasiya edilir. Bu səhifə sahələrə görə
qruplaşdırılmış kataloqdur. Dəyişənlərin çoxu həm də veb admin UI-dən redaktə
edilə bilər.
Konfiqurasiya modeli
Hər parametr sabit sıra ilə həll edilir:
database value → environment variable → built-in defaultBu o deməkdir ki, admin UI-də saxlanılan dəyər (verilənlər bazasında saxlanılır)
mühiti, mühit isə daxili standartı üstələyir. Bootstrap dəyişənləri — şlüzün
verilənlər bazasını oxuya bilməzdən əvvəl ehtiyac duyduğu dəyişənlər, məsələn
AIHUMMER_DATABASE_URL və AIHUMMER_MASTER_KEY — yalnız mühit olaraq qalır.
Host-native quraşdırma üçün konfiqurasiya faylı buradadır:
# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes[!TIP] Tənzimlənə bilən, bootstrap olmayan parametrləri ən yaxşısı veb admin UI-də dəyişməkdir ki, onlar faylları redaktə etmədən qüvvəyə minsin. Bəzi dəyişikliklər (alət açar/bağla və alt-agent dərinliyi kimi) dərhal tətbiq olunur; digərləri xidmətin yenidən başladılmasını tələb edir.
Nüvə və verilənlər bazası
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_DATABASE_URL |
Tələb olunur. Postgres DSN. Onsuz şlüz yalnız-sağlamlıq rejimində işləyir. |
AIHUMMER_DB_APP_URL |
Sətir Səviyyəsində Təhlükəsizliyi (RLS) aktivləşdirən məhdud-rol DSN (yerli quraşdırmalar üçün avtomatik təyin olunur). |
AIHUMMER_GATEWAY_ADDR |
Dinləmə ünvanı (standart :8780; quraşdırıcı boş port seçir). |
AIHUMMER_DEFAULT_WORKSPACE_ID |
Daxilolan dispetçeri və vidjetin standart iş sahəsini aktivləşdirir. |
AIHUMMER_BLOB_DIR |
Media/fayl xidmətini aktivləşdirir (blob saxlama qovluğu). |
AIHUMMER_ADMIN_UI_DIR |
Admin SPA-nı /admin/ ünvanında təqdim edir. |
AIHUMMER_WIDGET_DIR |
Veb vidjeti /widget/ ünvanında təqdim edir. |
Təhlükəsizlik və vault
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_MASTER_KEY |
base64-kodlaşdırılmış 32 bayt; saxlanmada-sirlər, vault və BYOK-u aktivləşdirir. |
AIHUMMER_MEDIA_TOKEN_SECRET |
İmzalanmış yükləmə URL-lərini yenidən başlatmalar arasında etibarlı saxlayır. |
AIHUMMER_APPROVAL_TOOLS |
İşləməzdən əvvəl insan-dövrədə təsdiq tələb edən alətlər. |
AIHUMMER_AIRGAPPED |
1 model-idarəli ictimai çıxışı bloklayır (air-gapped rejim). |
AIHUMMER_AUDIT_RETENTION_DAYS |
Admin audit jurnalı üçün saxlama müddəti. |
Autentifikasiya və SSO
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_OIDC_ISSUER |
/v1/admin/*-ı qoruyur. Onsuz (və LDAP/SAML olmadan) admin dev başlıqlarına etibar edir — belə nüsxəni heç vaxt açıq etməyin. |
LDAP/AD və SAML korporativ giriş üçün OIDC ilə yanaşı konfiqurasiya edilir; SCIM avtomatik istifadəçi təminatı təmin edir. Baxın Webhook-lar, SCIM və qoşalaşdırma.
Kanallar və daxilolan
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_INBOUND_SECRET |
Konnektor → şlüz /v1/inbound/* çağırışları üçün HMAC paylaşılan sirr. |
AIHUMMER_INBOUND_URL |
Konnektor tərəfi: konnektorun göndərdiyi şlüz daxilolan URL-i. |
LLM və modellər
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_LLM_PROVIDER |
İstifadə ediləcək model provayderi. |
AIHUMMER_LLM_MODEL |
Model adı. |
AIHUMMER_LLM_GATEWAY_URL |
OpenAI-uyğun LLM şlüzü üçün son nöqtə. |
AIHUMMER_OPENAI_API_KEY |
OpenAI-uyğun provayder üçün API açarı. |
AIHUMMER_SUBAGENT_MAX_DEPTH |
Yaradılan alt-agentlərin maksimum dərinliyi. |
[!NOTE] Heç bir model qoşulmayıbsa, şlüz deterministik mock-a keçir ki, sistem hələ də işləsin. Heç vaxt ödənişli model API tələb olunmur — pulsuz/yerli modellər və Codex/ChatGPT-abunəlik nəqliyyatı birinci dərəcəlidir.
Alətlər
| Dəyişən | Məqsəd |
|---|---|
SEARXNG_URL |
web_search alətini aktivləşdirir (SearXNG nüsxə URL-i). |
CLOAKBROWSER_CDP_URL |
browser/computer alətlərini aktivləşdirir (Chrome DevTools Protocol URL). |
AIHUMMER_FS_ROOT |
filesystem_read-i aktivləşdirir, bu kök altında sandbox edilir. |
AIHUMMER_DB_QUERY_DSN |
Bu DSN-ə qarşı db_query-ni (yalnız-oxuma) aktivləşdirir. |
AIHUMMER_CODE_EXEC |
code_exec alətini açar/bağlayar (paylaşılan hostlarda standart olaraq bağlı). |
Hər bir alətin nə etdiyi üçün tam Alətlər kataloqu-na baxın.
Səs və sidecar-lar
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_STT_URL |
Nitqdən-mətnə sidecar URL-i (quraşdırıcı tərəfindən avtomatik təyin olunur). |
AIHUMMER_TTS_URL |
Mətndən-nitqə sidecar URL-i (quraşdırıcı tərəfindən avtomatik təyin olunur). |
AIHUMMER_DIARIZE_URL |
Danışan-diarizasiya sidecar URL-i. |
AIHUMMER_VOICECLONE_URL |
Səs-klonlama sidecar URL-i. |
AIHUMMER_VIDEO_URL |
Video-anlama sidecar URL-i. |
Sidecar-lar ayrı HTTP xidmətləridir; şlüz onlara URL ilə çatır.
Vektorlar və embeddinglər
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_QDRANT_URL |
Real vektor anbarı (Qdrant). Yoxdursa → yaddaşdaxili anbar. |
AIHUMMER_EMBEDDER_URL |
Real embedder xidməti. Yoxdursa → hash embedder. |
Bus və müşahidə
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_NATS_URL |
Çatdırılma üçün istəyə bağlı NATS bus. |
AIHUMMER_OTEL_ENDPOINT |
İzlər/metriklər ötürmək üçün OTLP son nöqtəsi. |
[!WARNING] Müşahidə yalnız OTLP push-dur. AiHummer Prometheus
/metricsson nöqtəsini və ya/debug/pprof-u açmır. Bunun əvəzinəAIHUMMER_OTEL_ENDPOINT-i kollektorunuza yönəldin.
Yeniləmələr
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_DOWNLOAD_BASE_URL |
Buraxılış artefaktları üçün baza URL (özünü-yeniləmə mənbəyi). |
AIHUMMER_UPDATE_CHANNEL |
İzləniləcək buraxılış kanalı. |
AIHUMMER_AUTO_UPDATE |
Yeniləmə rejimi: off, check və ya apply. |
Açar-bağlı quraşdırma kanalları (alfa/beta/dev) əlavə olaraq quraşdırma zamanı
AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN-i oxuyur.
Marketpleys və plaginlər
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_BLOB_DIR |
Blob-anbar qovluğu. Media/fayllardan əlavə, deployerin həll etdiyi blob: istinadları altında özəl (side-load edilmiş) plagin artefaktlarını saxlayır. |
AIHUMMER_PLUGIN_PUBKEY |
Plagin imzalarını yoxlamaq üçün əlavə etibarlı açıq açar (base64 ed25519) — nüvədə bərkidilmiş reyestr açarına əlavə olaraq. |
AIHUMMER_PLUGIN_DEV_UNSIGNED |
1 imzasız plaginlərin quraşdırılmasına icazə verir. Yalnız yerli inkişaf üçün — heç vaxt xaricdən çatıla bilən nüsxədə. |
Etibar modeli (rəsmi → bərkidilmiş açar, özəl → etibar anbarı, imzasız → bloklanmış) Quraşdırma və yeniləmələr-də təsvir edilib.
Protokol səthləri (opt-in)
| Dəyişən | Məqsəd |
|---|---|
AIHUMMER_MCP_PUBLISH |
1 POST /v1/mcp-də xarici MCP serverini aktivləşdirir. |
AIHUMMER_A2A_PUBLISH |
1 A2A səthini aktivləşdirir (/.well-known/agent.json, /a2a/message). |
Sonra hara
- Hər dəyişənin hansı alətləri açdığını görün: Alətlər kataloqu.
- Nüsxəni gündəlik idarə edin: CLI istinadı.