Sidevogne — AiHummer Dokumenter

Sidevogne

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

Nogle funktioner — tale, video, websøgning, en headless browser — er ikke en del af selve gatewayen. De kører som sidevogne: små, uafhængige HTTP-tjenester, som gatewayen når ved URL. Hver sidevogn er gratis og lokal: der er ingen obligatorisk betalt API bag nogen af dem.

Hvad en sidevogn er

En sidecar er en separat proces, der eksponerer et HTTP-API. Gatewayen linker det aldrig ind eller kører det i processen — den kalder blot den URL, du konfigurerer. Hver sidecar

kører under sin egen systemd-enhed (vært-native, ingen containere),
er forbundet til gatewayen gennem en miljøvariabel, og
kan være installeret lokalt ved siden af gatewayen, eller peget på en eksisterende forekomst du løber allerede et andet sted.

Fordi kontrakten kun er HTTP, fungerer den samme konfiguration, uanset om sidecaren er tændt localhost eller på en anden vært.

[!NOTE] Sidecars er valgfrie — med én undtagelse: websøgning (SearXNG) og anti-detect-browseren (CloakBrowser) installeres direkte fra start. Deres pakker leveres inde i det signerede installationsbundle og installeres offline. Slå dem fra med installationsflagene --no-search og --no-browser. Alle andre funktioner er kun aktive, når deres URL er konfigureret; en minimal installation er stadig kun gatewayen plus PostgreSQL.

Sidevognene og deres porte

Havn	Sidevogn	Støttet af	Kræfter	Forbundet med
8001	STT	hurtigere-hvisken	tale-til-tekst	`AIHUMMER_STT_URL`
8002	TTS	edge-tts	tekst-til-tale	`AIHUMMER_TTS_URL`
8005	video	ffmpeg	videoforståelse	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	det `web_search` værktøj	installeres af installationsprogrammet, indstillingen er skjult; ekstern instans — `--external-search=URL`
9222	Chrome / CDP	Chrome (CDP)	det `browser` værktøj	installeres af installationsprogrammet, indstillingen er skjult; ekstern instans — `--external-browser=URL`

Voice-sidecars er den klar-til-brug vej: STT (:8001) fodrer agentens tur og TTS (:8002) taler svaret, både på gratis/lokale motorer. Videoforståelse (:8005) er en ekstra, valgfri sidecar. SearXNG (:8888) rygge web_search, og en Chrome/CDP-endpoint (:9222) støtter browser værktøj.

Ledningssidevogne

Du peger gatewayen på hver sidevogn med den matchende katalogindstilling — fra admin UI (Administration → Indstillinger) eller med aihummer settings set. gateway.env er kun bootstrap og ignoreres for disse nøgler. For den host-native installation er stemmesidecars (STT/TTS) konfigureret for dig; websøgning og browseren forbindes af selve installationsprogrammet — du angiver aldrig deres adresser, og de vises ikke i indstillingerne; resten aktiverer du efter behov.

# 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] Fordi hver sidevogn bare er en URL, kan du centralisere tunge tjenester. Peg flere gateways på én delt STT/TTS-instans i stedet for at køre en kopi pr. vært; for søgning og browseren gør installationsflagene --external-search=URL og --external-browser=URL det samme.

Kører dem lokalt eller delt

Hver sidecar kører under sin egen systemd-enhed på værten, så du betjener den som enhver anden service — start, stop og læs logs uafhængigt af gatewayen. Hvis du allerede kører for eksempel en SearXNG- eller en Chrome/CDP-endpoint, giver du installationsprogrammet --external-search=URL eller --external-browser=URL: der installeres ingen lokal kopi, og gatewayen kalder din instans i stedet. For stemme og video peger du den matchende indstilling på den eksisterende instans. Under alle omstændigheder er gatewayens udsyn identisk: en konfigureret URL, som den kan kalde.

[!WARNING] Den browser (CDP) og web_search værktøjer rækker ud til netværket. Tændt gennemgang af udgående trafik og den luftafskårne indstilling for hærdede eller luftafskårne installationer før du aktiverer dem — gatewayen kalder kun en sidecar, som du har forbundet.

Hvor til næste

Hvordan stemme og browserværktøjet bruges i en tur: Gateway og drejemotor.
Den minimale hårde afhængighed (PostgreSQL) og alt andet valgfrit: Gateway og drejemotor.