AiHummer
Norsk
Logg påKonto
v1.0.x
{ }Swagger

Sidevogner

v1.0.x · oppdatert 2026-07-05

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-search og --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=URL og --external-browser=URL det 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) og web_search verktø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