Sidevogner
Noen funksjoner — tale, video, nettsøk, en hodløs nettleser — er ikke en del av selve gatewayen. De kjører som sidevogner: små, uavhengige HTTP-tjenester som gatewayen når ved URL. Hver sidevogn er gratis og lokal: det finnes ingen obligatorisk betalt API bak noen av dem.
Hva en sidevogn er
En sidevogn er en separat prosess som eksponerer et HTTP-API. Gatewayen kobler det aldri inn eller kjører det i prosessen — den kaller bare URL-en du konfigurerer. Hver sidevogn
- kjører under sin egen systemd-enhet (vert-vertsystem, ingen containere),
- er koblet til gatewayen gjennom en miljøvariabel, og
- kan være installert lokalt ved siden av gatewayen, eller pekt mot en eksisterende forekomst du løper allerede et annet sted.
Fordi kontrakten bare er HTTP, fungerer den samme konfigurasjonen uansett om sidecaren er på localhost eller på en annen vert.
[!NOTE] Sidevogner er valgfrie — med ett unntak: nettsøk (SearXNG) og antidetekt-nettleseren (CloakBrowser) installeres rett ut av boksen. Nyttelasten deres leveres inne i den signerte installasjonspakken og installeres frakoblet. Slå dem av med installasjonsflaggene
--no-searchog--no-browser. Alle andre funksjoner er bare aktive når URL-en er konfigurert; en minimal installasjon er fortsatt bare gatewayen pluss PostgreSQL.
Sidetaskingene og portene deres
| Havn | Sidevogn | Støttet av | Krefter | Kablet med |
|---|---|---|---|---|
| 8001 | STT | raskere-hviske | 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 verktøy |
installeres av installasjonsprogrammet, innstillingen er skjult; ekstern instans — --external-search=URL |
| 9222 | Chrome / CDP | Chrome (CDP) | det browser verktøy |
installeres av installasjonsprogrammet, innstillingen er skjult; ekstern instans — --external-browser=URL |
Voice-sidecars er den ferdiglagde veien: STT (:8001) mater agentens tur og TTS (:8002) sier svaret, både på gratis/lokale motorer. Videoforståelse (:8005) er en ekstra, valgfri sidecar. SearXNG (:8888) rygg web_search, og et Chrome/CDP-endepunkt (:9222) støtter browser verktøy.
Kabling av sidevogner
Du peker gatewayen mot hver sidevogn med den matchende kataloginnstilling — fra administrasjonsgrensesnittet (Administrasjon → Innstillinger) eller med aihummer settings set. gateway.env er kun for bootstrap og ignoreres for disse nøklene. For den vert-nasjonale installasjonen er stemme-sidecarene (STT/TTS) konfigurert for deg; nettsøk og nettleseren kobles opp av selve installasjonsprogrammet — du setter aldri adressene deres, og de vises ikke i innstillingene; resten aktiverer du etter 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 sentralisere tunge tjenester. Pek flere gatewayer mot én delt STT/TTS-instans i stedet for å kjøre en kopi per vert; for søk og nettleseren gjør installasjonsflaggene
--external-search=URLog--external-browser=URLdet samme.
Kjøre dem lokalt eller delt
Hver sidecar kjører under sin egen systemd-enhet på verten, så du opererer den som hvilken som helst annen tjeneste — start, stopp og les logger uavhengig av gatewayen. Hvis du allerede kjører for eksempel en SearXNG- eller et Chrome/CDP-endepunkt, gi installasjonsprogrammet --external-search=URL eller --external-browser=URL: ingen lokal kopi installeres, og gatewayen kaller din instans i stedet. For stemme og video peker du den tilsvarende innstillingen mot den eksisterende instansen. Uansett er gatewayens syn identisk: en konfigurert URL den kan kalle.
[!WARNING] Den
browser(CDP) ogweb_searchverktøy når ut til nettverket. På gjennomgang av utgående trafikk og den luftgapte innstillingen for herdede eller luftgapte distribusjoner før du aktiverer dem — gatewayen kaller bare en sidevogn som du har koblet til.
Hvor til neste
- Hvordan stemmen og nettleserverktøyet brukes i en tur: Gateway og svingemotor.
- Den minimale harde avhengigheten (PostgreSQL) og alt annet som valgfrie tillegg: Gateway og svingemotor.