Variabile de mediu — AiHummer Documentație

AiHummer este configurat prin variabile de mediu AIHUMMER_* (plus câteva specifice instrumentelor, precum SEARXNG_URL). Această pagină este catalogul, grupat pe domenii. Majoritatea variabilelor pot fi editate și din interfața web de administrare.

Modelul de configurare

Fiecare setare este rezolvată într-o ordine fixă:

database value  →  environment variable  →  built-in default

Asta înseamnă că o valoare salvată în interfața de administrare (stocată în baza de date) are prioritate față de mediu, care la rândul lui are prioritate față de valoarea implicită încorporată. Variabilele de bootstrap — cele de care gateway-ul are nevoie înainte de a putea citi baza de date, precum AIHUMMER_DATABASE_URL și AIHUMMER_MASTER_KEY — rămân exclusiv de mediu.

Fișierul de configurare pentru o instalare nativă pe gazdă se află la:

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

[!TIP] Butoanele reglabile, care nu țin de bootstrap, sunt cel mai bine modificate în interfața web de administrare, astfel încât să intre în vigoare fără a edita fișiere. Unele schimbări (precum comutatoarele de instrumente și adâncimea sub-agenților) se aplică la cald; altele necesită o repornire a serviciului.

Nucleu și baza de date

Variabilă	Scop
`AIHUMMER_DATABASE_URL`	Obligatoriu. DSN Postgres. Fără el, gateway-ul rulează în mod doar-sănătate.
`AIHUMMER_DB_APP_URL`	DSN cu rol restricționat care activează Row-Level Security (setat automat pentru instalările locale).
`AIHUMMER_GATEWAY_ADDR`	Adresa de ascultare (implicit `:8780`; programul de instalare alege un port liber).
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Activează dispecerul de intrare și spațiul de lucru implicit al widget-ului.
`AIHUMMER_BLOB_DIR`	Activează serviciul de media/fișiere (directorul de stocare a blob-urilor).
`AIHUMMER_ADMIN_UI_DIR`	Servește SPA-ul de administrare la `/admin/`.
`AIHUMMER_WIDGET_DIR`	Servește widget-ul web la `/widget/`.

Securitate și vault

Variabilă	Scop
`AIHUMMER_MASTER_KEY`	32 de octeți codificați în base64; activează secretele în repaus, vault-ul și BYOK.
`AIHUMMER_MEDIA_TOKEN_SECRET`	Menține valide URL-urile de descărcare semnate între reporniri.
`AIHUMMER_APPROVAL_TOOLS`	Instrumente care necesită aprobare umană (human-in-the-loop) înainte de a rula.
`AIHUMMER_AIRGAPPED`	`1` blochează egresul public controlat de model (modul air-gapped).
`AIHUMMER_AUDIT_RETENTION_DAYS`	Fereastra de păstrare pentru jurnalul de audit al administratorului.

Autentificare și SSO

Variabilă	Scop
`AIHUMMER_OIDC_ISSUER`	Protejează `/v1/admin/*`. Fără el (și fără LDAP/SAML), administrarea are încredere în antetele de dezvoltare — nu expune niciodată o astfel de instanță.

LDAP/AD și SAML se configurează alături de OIDC pentru autentificarea de tip enterprise; SCIM oferă provisioning automat al utilizatorilor. Vezi Webhooks, SCIM și pairing.

Canale și intrare

Variabilă	Scop
`AIHUMMER_INBOUND_SECRET`	Secret HMAC partajat pentru apelurile conector → gateway `/v1/inbound/*`.
`AIHUMMER_INBOUND_URL`	Partea de conector: URL-ul de intrare al gateway-ului către care postează un conector.

LLM și modele

Variabilă	Scop
`AIHUMMER_LLM_PROVIDER`	Furnizorul de model de utilizat.
`AIHUMMER_LLM_MODEL`	Numele modelului.
`AIHUMMER_LLM_GATEWAY_URL`	Endpoint pentru un gateway LLM compatibil cu OpenAI.
`AIHUMMER_OPENAI_API_KEY`	Cheie API pentru un furnizor compatibil cu OpenAI.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Adâncimea maximă a sub-agenților generați.

[!NOTE] Dacă niciun model nu este conectat, gateway-ul revine la un mock determinist, astfel încât sistemul să funcționeze în continuare. Nu este niciodată necesar un API de model plătit — modelele gratuite/locale și un transport de tip abonament Codex/ChatGPT sunt de primă clasă.

Instrumente

Variabilă	Scop
`SEARXNG_URL`	Activează instrumentul `web_search` (URL-ul unei instanțe SearXNG).
`CLOAKBROWSER_CDP_URL`	Activează instrumentele `browser`/`computer` (URL Chrome DevTools Protocol).
`AIHUMMER_FS_ROOT`	Activează `filesystem_read`, izolat sub această rădăcină.
`AIHUMMER_DB_QUERY_DSN`	Activează `db_query` (doar citire) împotriva acestui DSN.
`AIHUMMER_CODE_EXEC`	Comută instrumentul `code_exec` (dezactivat implicit pe gazdele partajate).

Vezi Catalogul de instrumente complet pentru ce face fiecare instrument.

Voce și sidecar-uri

Variabilă	Scop
`AIHUMMER_STT_URL`	URL-ul sidecar-ului de speech-to-text (setat automat de programul de instalare).
`AIHUMMER_TTS_URL`	URL-ul sidecar-ului de text-to-speech (setat automat de programul de instalare).
`AIHUMMER_DIARIZE_URL`	URL-ul sidecar-ului de diarizare a vorbitorilor.
`AIHUMMER_VOICECLONE_URL`	URL-ul sidecar-ului de clonare a vocii.
`AIHUMMER_VIDEO_URL`	URL-ul sidecar-ului de înțelegere video.

Sidecar-urile sunt servicii HTTP separate; gateway-ul le accesează prin URL.

Vectori și embeddings

Variabilă	Scop
`AIHUMMER_QDRANT_URL`	Stocare vectorială reală (Qdrant). Absentă → stocare în memorie.
`AIHUMMER_EMBEDDER_URL`	Serviciu real de embedder. Absent → embedder bazat pe hash.

Magistrală și observabilitate

Variabilă	Scop
`AIHUMMER_NATS_URL`	Magistrală NATS opțională pentru livrare.
`AIHUMMER_OTEL_ENDPOINT`	Endpoint OTLP pentru push de trasări/metrici.

[!WARNING] Observabilitatea este doar push OTLP. AiHummer nu expune un endpoint Prometheus /metrics sau /debug/pprof. Îndreaptă în schimb AIHUMMER_OTEL_ENDPOINT către colectorul tău.

Actualizări

Variabilă	Scop
`AIHUMMER_DOWNLOAD_BASE_URL`	URL de bază pentru artefactele de versiune (sursa de auto-actualizare).
`AIHUMMER_UPDATE_CHANNEL`	Canalul de versiune de urmărit.
`AIHUMMER_AUTO_UPDATE`	Mod de actualizare: `off`, `check` sau `apply`.

Canalele de instalare protejate prin cheie (alfa/beta/dev) citesc suplimentar AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN la momentul instalării.

Marketplace și pluginuri

Variabilă	Scop
`AIHUMMER_BLOB_DIR`	Directorul de stocare a blob-urilor. Pe lângă media/fișiere, stochează artefactele de plugin private (încărcate lateral) sub referințe `blob:` pe care deployer-ul le rezolvă.
`AIHUMMER_PLUGIN_PUBKEY`	O cheie publică de încredere suplimentară (ed25519 în base64) pentru verificarea semnăturilor de pluginuri — pe lângă cheia de registru fixată în nucleu.
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` permite instalarea pluginurilor nesemnate. Doar pentru dezvoltare locală — niciodată pe o instanță accesibilă din exterior.

Modelul de încredere (oficial → cheie fixată, privat → trust store, nesemnat → blocat) este descris în Instalare și actualizări.

Suprafețe de protocol (opțional)

Variabilă	Scop
`AIHUMMER_MCP_PUBLISH`	`1` activează serverul MCP exterior la `POST /v1/mcp`.
`AIHUMMER_A2A_PUBLISH`	`1` activează suprafața A2A (`/.well-known/agent.json`, `/a2a/message`).

Unde mergi mai departe

Vezi ce instrumente deblochează fiecare variabilă: Catalog de instrumente.
Operează instanța zi de zi: Referință CLI.