Cerințe de sistem — AiHummer Documentație

AiHummer este un produs nativ pe gazdă: rulează ca un release tarball sub systemd, astfel încât cerințele sunt deliberat mici. Singura dependență dură este o gazdă Linux cu PostgreSQL. Orice altceva — sidecars, un model real, un vector store — este opțional și poate fi adăugat ulterior din interfața de administrare.

[!NOTE] AiHummer este nativ pe gazdă, nu Docker. Se deployează ca un tarball care rulează sub systemd din /home/.aihummer. Nu ai nevoie de un runtime de containere, Kubernetes sau vreun orchestrator.

Sistem de operare

AiHummer rulează doar pe Linux. Nu există niciun build de server Windows sau macOS — gateway-ul și sidecars-urile sale sunt împachetate ca artefacte Linux per arhitectură și sunt deployate cu systemd. (Clientul este o aplicație mobilă și desktop separată; aceea este un canal, nu serverul.)

O distribuție Linux modernă pe 64 de biți cu systemd.
x86_64 (amd64) sau arm64 — installer-ul extrage bundle-ul per arhitectură potrivit.
Acces sudo/root pentru a scrie rădăcina de instalare și a înregistra unități systemd.

Bază de date

PostgreSQL este singura dependență dură și sursa unică a adevărului pentru toată starea. Extensia pgcrypto este necesară — ea susține vault-ul criptat de credențiale. Fără o bază de date, gateway-ul pornește într-un mod redus doar-sănătate și nu servește nimic util.

[!IMPORTANT] Activează pgcrypto în baza de date țintă înainte de prima rulare:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gateway-ul se conectează printr-un DSN în AIHUMMER_DATABASE_URL. Pentru izolare multitenant poți de asemenea îndrepta AIHUMMER_DB_APP_URL către un rol aihummer_app restricționat pentru a activa Postgres Row-Level Security; instalările locale configurează acest lucru automat. Migrările de bază de date sunt sigure pentru viitor și aplicate automat sub un lock consultativ pe pool-ul proprietar.

Hardware

Aceste cifre sunt orientative pentru un deployment pe o singură gazdă al gateway-ului plus PostgreSQL. Sidecars-urile (STT/TTS, browser, vector store) adaugă propria amprentă și sunt de obicei plasate pe aceeași gazdă doar pentru deployment-uri mici.

Profile	CPU	RAM	Disk	Notes
Minim (eval)	2 vCPU	2 GB	10 GB	Gateway + Postgres, model mock, fără sidecars
Recomandat	4 vCPU	8 GB	40 GB SSD	Gateway + Postgres + câteva sidecars
Voce / modele locale	8+ vCPU (GPU opțional)	16+ GB	80+ GB SSD	STT/TTS, embedder, endpoint LLM local

Utilizarea discului crește cu istoricul conversațiilor, directorul de blob-uri media (AIHUMMER_BLOB_DIR), ingerarea de cunoștințe și retenția de audit. Planifică backup-uri PostgreSQL (pg_dump + WAL/PITR) în consecință.

Sidecars (opțional)

Sidecars-urile sunt servicii HTTP separate, fiecare sub propria unitate systemd. Gateway-ul le accesează prin URL, astfel încât un sidecar poate rula pe aceeași gazdă, pe altă gazdă, sau poți îndrepta către o instanță existentă. Toate sunt gratuite/locale și niciodată necesare pentru un deployment de bază.

Sidecar	Default port	Enables
STT (faster-whisper)	8001	Speech-to-text pentru tururi vocale
TTS (edge-tts)	8002	Text-to-speech pentru tururi vocale
Diarize (pyannote)	8003	Diarizare a vorbitorilor
Voiceclone (OpenVoice V2)	8004	Clonare de voce
Video (ffmpeg)	8005	Înțelegere video
SearXNG	8888	Instrumentul `web_search`
Chrome/CDP	9222	Instrumentele `browser` / `computer`

Installer-ul poate proviziona sidecars nativ sau poți atașa unul existent prin URL — vezi Instalare.

Furnizori LLM

AiHummer nu necesită niciodată un model plătit. Funcționează din start pe modele gratuite/locale și pe un transport prin abonament Codex/ChatGPT; cheile BYOK per tenant sunt strict opționale.

Furnizori suportați:

Anthropic.
OpenAI.
Orice endpoint standard OpenAI-API — servere de modele locale, OpenRouter, sau endpoint-ul compatibil OpenAI al Gemini, de exemplu.
Transport prin abonament Codex / ChatGPT — conduce un model printr-un abonament ChatGPT mai degrabă decât printr-o cheie de API facturată.

[!TIP] Dacă pornești gateway-ul fără un model cablat (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), răspunsurile vin de la un mock determinist, astfel încât să poți valida canalele și rutarea înainte de a conecta un model real.

[!NOTE] AiHummer expune doar endpoint-ul compatibil OpenAI POST /v1/chat/completions. Nu există un endpoint HTTP /v1/models sau /v1/embeddings, iar observabilitatea este OTLP-push (fără Prometheus /metrics).

Unde mergi mai departe

Gata de deployment? Mergi la Instalare.
Vrei să parcurgi prima rulare pas cu pas? Vezi Quickstart.
Vrei mai întâi modelul mental? Citește Introducere.