Cerințe de sistem — AiHummer Documentație

AiHummer este un produs nativ pentru gazdă: rulează ca un pachet tarball de release sub systemd, astfel încât cerințele sunt intenționat reduse. Singura dependență strictă este o gazdă Linux cu PostgreSQL. Tot ce este în plus — sidecar-uri, un model real, un magazin de vectori — este opțional și poate fi adăugat mai târziu din interfața de administrare.

[!NOTE] AiHummer este gazdă-native, nu Docker. Se desfășoară ca un tarball care rulează sub systemd de la ~/.aihummer (directorul de acasă al utilizatorului care a rulat installer). Nu aveți nevoie de un runtime pentru containere, Kubernetes sau orice dirijor.

Sistem de operare

AiHummer funcționează pe Doar Linux. Nu există o versiune server pentru Windows sau macOS — gateway-ul și sidecar-urile sale sunt împachetate ca artefacte Linux pe arhitectură specifică și sunt implementate cu systemd. (Clientul este o aplicație separată pentru mobil și desktop; acesta este un canal, nu serverul.)

O distribuție Linux modernă pe 64 de biți cu systemd.
x86_64 (amd64) sau arm64 — instalatorul descarcă pachetul corespunzător fiecărei arhitecturi.
sudoAcces root este nu este strict necesar: o instalare normală rulează prin sudo, dar rularea programului de instalare fără root instalează AiHummer în modul fără root mod sub systemd --user — vezi Instalare.

Bază de date

PostgreSQL este doar dependență tare și singura sursă de adevăr pentru tot statul. pgcrypto extensie este necesar — suportă seiful de acreditări criptate. Fără o bază de date, gateway-ul pornește în modul redus numai pentru sănătate și nu servește nimic util.

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

Gateway-ul se conectează printr-un DSN în AIHUMMER_DATABASE_URL. Pentru izolarea multi-tenant, puteți, de asemenea, să indicați AIHUMMER_DB_APP_URL la un loc restricționat aihummer_app rol pentru a activa Securitatea la Nivel de Rând din Postgres; instalările locale configurează acest lucru automat. Migrațiile bazei de date sunt sigure pe termen lung și sunt aplicate automat sub un blocaj consultativ pe pool-ul proprietarului.

Hardware

Aceste cifre sunt orientative pentru o implementare pe un singur gazdă a gateway-ului plus PostgreSQL. Sidecar-urile (STT/TTS, browser, depozit de vectori) adaugă propria amprentă și sunt de obicei plasate pe aceeași gazdă doar pentru implementări mici.

Profil	CPU	RAM	Disc	Note
Minim (eval)	2 vCPU	2 GB	10 GB	Gateway + Postgres, model mock, fără sidecars
Recomandat	4 vCPU	8 GB	SSD de 40 GB	Gateway + Postgres + câteva sidecar-uri
Modele vocale / locale	8+ vCPU (GPU opțional)	16+ GB	SSD de peste 80 GB	STT/TTS, embedder, punct final LLM local

Utilizarea discului crește odată cu istoricul conversațiilor, directorul blob-urilor media (AIHUMMER_BLOB_DIR), ingestia și păstrarea auditului cunoștințelor. Planificați backup-urile PostgreSQL (pg_dump + WAL/PITR) în consecință.

Atelaje laterale (opțional)

Sidecarurile sunt servicii HTTP separate, fiecare sub propria unitate systemd. Gateway-ul ajunge la ele prin URL, astfel încât un sidecar poate rula pe același gazdă, pe o altă gazdă sau poți indica către o instanță existentă. Toate sunt gratuite/locale și nu sunt niciodată necesare pentru o implementare de bază.

Atelaj lateral	Port implicit	Permite
STT (faster-whisper)	8001	Recunoașterea vocală pentru conversațiile prin voce
TTS (edge-tts)	8002	Text-la-vorbire pentru schimbările de voce
Video (ffmpeg)	8005	Întelegerea videoclipului
SearXNG	8888	`web_search` unealtă
Chrome/CDP	9222	`browser` / `computer` unelte

STT, TTS, video, căutarea web (SearXNG) și browserul (CloakBrowser) sunt toate instalate din start de către instalator. Încărcăturile de căutare și browser sunt livrate în pachetul semnat al instalatorului și se instalează offline: le dezactivezi cu --no-search / --no-browser, sau atașezi o instanță pe care o rulezi deja cu --external-search=URL / --external-browser=URL în locul unei instalări locale. Sari peste sidecar-urile de voce cu AIHUMMER_SKIP_* variabile. Încărcătorul semantic este opțional (--with-embedder): descarcă PyTorch (sute de MB), iar fără acesta memoria revine la căutarea lexicală. Vezi Instalare.

[!NOTE] Node.js (versiunea 20 sau mai nouă) este de asemenea livrat în pachetul instalatorului și se instalează offline, astfel încât pluginurile Node.js — aplicația AiHummer, pocket-agent și conectorii de canale — funcționează din start chiar și pe distribuții al căror Node.js propriu este prea vechi.

Furnizori LLM

AiHummer nu necesită niciodată un model plătit. Funcționează imediat cu modele gratuite/la scară locală și cu un transport pe bază de abonament Codex/ChatGPT; cheile BYOK pentru fiecare tenant sunt strict opționale.

Furnizori suportați:

Antropic.
OpenAI.
Orice punct final standard OpenAI-API — servere de modele locale, OpenRouter, sau De exemplu, punctul final compatibil cu OpenAI al Gemini.
Transport Codex / abonament ChatGPT — conduce un model printr-un ChatGPT abonament mai degrabă decât o cheie API facturată.

[!TIP] Dacă pornești gateway-ul fără un model conectat (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), răspunsurile provin de la un determinist batjocori astfel încât să puteți valida canalele și rutare înainte de conectarea unui model real.

[!NOTE] AiHummer expune doar compatibilul cu OpenAI POST /v1/chat/completions punct final. Există nu /v1/models sau /v1/embeddings Punct final HTTP și observabilitatea este OTLP-push (fără Prometheus) /metrics).

Unde următor?

Gata de implementare? Mergi la Instalare.
Vrei să parcurgi prima alergare pas cu pas? Vezi Ghid rapid.
Vrei mai întâi modelul mental? Citește Introducere.