Atelaje laterale

v1.1.x · actualizat 2026-07-05

Unele capacități — vorbire, video, căutare pe web, un browser fără interfață grafică — nu fac parte din gateway în sine. Ele rulează ca motoscaune: servicii HTTP mici și independente la care gateway-ul ajunge prin URL. Fiecare sidecar este gratuit și local: nu există niciun API plătit obligatoriu în spatele niciunuia dintre ele.

Ce este un sidecar

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

rulează sub unitatea sa systemd (gazdă-native, fără containere),
este conectat la gateway printr-o variabilă de mediu, și
poate fi instalat nativ lângă gateway sau orientat către unul existent instanță tu deja alergi în altă parte.

Deoarece contractul este doar HTTP, aceeași configurație funcționează indiferent dacă sidecar-ul este activ localhost sau pe un alt gazdă.

[!NOTE] Atelajele laterale sunt opționale — cu o singură excepție: căutarea web (SearXNG) și browserul anti-detecție (CloakBrowser) sunt instalate din start. Încărcăturile lor sunt livrate în pachetul semnat al instalatorului și se instalează offline. Le dezactivezi cu opțiunile instalatorului --no-search și --no-browser. Orice altă capacitate este activă doar atunci când URL-ul ei este configurat; o instalare minimală rămâne doar gateway-ul plus PostgreSQL.

Atelajele laterale și porturile lor

Port	Atelaj lateral	Susținut de	Puteri	Conectat cu cablu
8001	STT	șoaptă-mai-repede	discurs-în-text	`AIHUMMER_STT_URL`
8002	TTS	edge-tts	text-în-vorbire	`AIHUMMER_TTS_URL`
8005	video	ffmpeg	înțelegerea videoclipului	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	`web_search` unealtă	instalat de instalator, setarea este ascunsă; instanță externă — `--external-search=URL`
9222	Chrome / CDP	Chrome (CDP)	`browser` unealtă	instalat de instalator, setarea este ascunsă; instanță externă — `--external-browser=URL`

Sidecarii de voce sunt calea pregătită din cutie: STT (:8001) alimentează agentul cu dialog și TTS (:8002) rostește răspunsul, atât pe motoare gratuite/locale. Înțelegerea videoclipului (:8005) este un sidecar suplimentar, opțional. SearXNG (:8888) susține web_search, și un punct final Chrome/CDP (:9222) sprijină browser unealtă.

Cablarea sidecar-urilor

Îndrepti gateway-ul către fiecare sidecar cu corespondența setare catalog — din interfața de administrare (Management → Setări) sau cu aihummer settings set. gateway.env Este doar pentru bootstrap și este ignorat pentru aceste chei. Pentru instalarea nativă pe gazdă, fișierele audio suplimentare de voce (STT/TTS) sunt configurate pentru tine; căutarea web și browserul sunt conectate chiar de instalator — nu le setezi niciodată adresele și ele nu apar în setări; restul le activezi după cum este necesar.

# Voice in/out (auto-configured by the installer for STT/TTS)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002

# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

[!TIP] Pentru că fiecare sidecar este doar un URL, poți centraliza serviciile grele. Îndreaptă mai multe gateway-uri către o singură instanță STT/TTS partajată în loc să rulezi câte o copie pe fiecare gazdă; pentru căutare și browser, opțiunile instalatorului --external-search=URL și --external-browser=URL fac același lucru.

Rularea lor nativ sau partajat

Fiecare sidecar trăiește sub propria unitate systemd pe gazdă, deci îl operezi ca orice alt serviciu — pornești, oprești și citești jurnalele independent de gateway. Dacă rulezi deja, să zicem, un SearXNG sau un endpoint Chrome/CDP, transmite instalatorului --external-search=URL sau --external-browser=URL: nu se instalează nicio copie locală, iar gateway-ul apelează instanța ta. Pentru voce și video, îndreaptă setarea corespunzătoare către instanța existentă. În ambele cazuri, perspectiva gateway-ului este identică: un URL configurat pe care îl poate apela.

[!WARNING] browser (CDP) și web_search unelte ajung la rețea. Pornit revizuirea implementărilor consolidate sau izolate de acces examinează ieșirile și setarea izolată înainte de a le activa — gateway-ul apelează doar un sidecar pe care l-ai conectat.

Unde următor?

Cum sunt folosite vocea și instrumentul browser într-o tură: Poartă și motor de virare.
Dependența minimă obligatorie (PostgreSQL) și totul altceva opțional: Poartă și motor de virare.