AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Arhitectură/Sidecars

Sidecars

v1.0.x · actualizat 2026-06-26

Unele capabilități — vorbire, video, căutare web, un browser headless — nu fac parte din gateway-ul în sine. Acestea rulează ca sidecars: servicii HTTP mici și independente pe care gateway-ul le accesează prin URL. Fiecare sidecar este gratuit și local: nu există niciun API plătit obligatoriu în spatele vreunuia dintre ele.

Ce este un sidecar

Un sidecar este un proces separat care expune un API HTTP. Gateway-ul nu îl leagă niciodată și nu îl rulează în proces — pur și simplu apelează URL-ul pe care îl configurați. Fiecare sidecar

  • rulează sub propria unitate systemd (nativ pe gazdă, fără containere),
  • este cablat la gateway printr-o variabilă de mediu și
  • poate fi instalat nativ lângă gateway sau direcționat către o instanță existentă pe care o rulați deja în altă parte.

Deoarece contractul este doar HTTP, aceeași configurație funcționează indiferent dacă sidecarul este pe localhost sau pe altă gazdă.

[!NOTE] Sidecar-urile sunt opționale. O capabilitate este activă doar atunci când URL-ul său este configurat; până atunci gateway-ul rulează fără el. Acest lucru menține o instalare minimă la doar gateway plus PostgreSQL.

Sidecar-urile și porturile lor

Port Sidecar Susținut de Alimentează Cablat cu
8001 STT faster-whisper speech-to-text AIHUMMER_STT_URL
8002 TTS edge-tts text-to-speech AIHUMMER_TTS_URL
8003 diarize pyannote diarizarea vorbitorilor AIHUMMER_DIARIZE_URL
8004 voiceclone OpenVoice V2 clonare vocală AIHUMMER_VOICECLONE_URL
8005 video ffmpeg înțelegerea video AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG instrumentul web_search SEARXNG_URL
9222 Chrome / CDP Chrome (CDP) instrumentul browser CLOAKBROWSER_CDP_URL

Sidecar-urile de voce sunt calea predefinită: STT (:8001) alimentează turul agentului, iar TTS (:8002) rostește răspunsul, ambele pe motoare gratuite/locale. Diarizarea (:8003), clonarea vocală (:8004) și înțelegerea video (:8005) sunt sidecar-uri suplimentare, opt-in. SearXNG (:8888) susține web_search, iar un endpoint Chrome/CDP (:9222) susține instrumentul browser.

Cablarea sidecar-urilor

Direcționați gateway-ul către fiecare sidecar cu variabila de mediu corespunzătoare. Pentru instalarea nativă pe gazdă, sidecar-urile de voce (STT/TTS) sunt configurate pentru dumneavoastră; pe restul le activați după nevoie.

# gateway.env — voice in/out (auto-set by the installer for STT/TTS)
AIHUMMER_STT_URL=http://127.0.0.1:8001
AIHUMMER_TTS_URL=http://127.0.0.1:8002

# Optional voice/video sidecars
AIHUMMER_DIARIZE_URL=http://127.0.0.1:8003
AIHUMMER_VOICECLONE_URL=http://127.0.0.1:8004
AIHUMMER_VIDEO_URL=http://127.0.0.1:8005

# Tool sidecars
SEARXNG_URL=http://127.0.0.1:8888
CLOAKBROWSER_CDP_URL=http://127.0.0.1:9222

[!TIP] Deoarece fiecare sidecar este doar un URL, puteți centraliza serviciile grele. Direcționați mai multe gateway-uri către o singură instanță partajată STT/TTS sau SearXNG, în loc să rulați o copie per gazdă.

Rularea lor nativă sau partajată

Fiecare sidecar trăiește sub propria unitate systemd pe gazdă, deci îl operați ca pe orice alt serviciu — porniți, opriți și citiți jurnalele independent de gateway. Dacă rulați deja, să zicem, un endpoint SearXNG sau Chrome/CDP, pur și simplu setați URL-ul către acea instanță existentă și săriți complet peste instalarea locală. În oricare caz, perspectiva gateway-ului este identică: un URL configurat pe care îl poate apela.

[!WARNING] Instrumentele browser (CDP) și web_search ajung la rețea. În implementările securizate sau izolate (air-gapped), revizuiți egress-ul și setarea air-gapped înainte de a le activa — gateway-ul apelează doar un sidecar pe care l-ați cablat.

Unde mergem mai departe