Sidvagnar

# 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

Vissa funktioner — tal, video, webbsökning, en huvudlös webbläsare — är inte en del av själva gatewayen. De körs som **sidvagnar**: små, oberoende HTTP-tjänster som gatewayen når **via URL**. Varje sidvagn är **gratis och lokal**: det finns inget obligatoriskt betalt API bakom någon av dem. ## Vad en sidvagn är En sidvagn är en separat process som exponerar ett HTTP-API. Gatewayen länkar aldrig in den eller kör den i processen – den anropar helt enkelt den URL du konfigurerar. Varje sidvagn - kör under **sin egen systemd-enhet** (värd-native, inga containrar), - är ansluten till gatewayen genom en miljövariabel, och - kan vara **installerad lokalt bredvid gatewayen, eller riktad mot en befintlig instans** du springer redan någon annanstans. Eftersom kontraktet bara är HTTP, fungerar samma konfiguration oavsett om sidovagnen är på `localhost` eller på en annan värd. > [!NOTE] > Sidvagnar är valfria — med ett undantag: webbsökningen (SearXNG) och > anti-detekteringswebbläsaren (CloakBrowser) installeras direkt ur lådan. Deras > nyttolaster levereras inuti det signerade installationspaketet och installeras > offline. Stäng av dem med installationsflaggorna `--no-search` och `--no-browser`. > Alla andra funktioner är aktiva först när deras URL är konfigurerad; en minimal > installation är fortfarande bara gatewayen plus PostgreSQL. ## Sidovagnarna och deras portar | Port | Sidvagn | Stöds av | Krafter | Uppkopplad med | |---|---|---|---|---| | 8001 | STT | snabbare-viskning | tal-till-text | `AIHUMMER_STT_URL` | | 8002 | TTS | edge-tts | text-till-tal | `AIHUMMER_TTS_URL` | | 8005 | video | ffmpeg | videoförståelse | `AIHUMMER_VIDEO_URL` | | 8888 | SearXNG | SearXNG | det `web_search` verktyg | installeras av installationsprogrammet, inställningen dold; extern instans — `--external-search=URL` | | 9222 | Chrome / CDP | Chrome (CDP) | det `browser` verktyg | installeras av installationsprogrammet, inställningen dold; extern instans — `--external-browser=URL` | Röst-sidecarerna är den färdiga lösningen: STT (`:8001`) matar agentens tur och TTS (`:8002`) talar svaret, både på fria/lokala motorer. Videoförståelse (`:8005`) är en ytterligare, frivillig sidovagn. SearXNG (`:8888`) ryggar `web_search`, och en Chrome/CDP-endpoint (`:9222`) stöder `browser` verktyg. ## Koppla sidovagnar Du riktar gatewayen mot varje sidovagn med den matchande **kataloginställning** — från administratörsgränssnittet (**Administration → Inställningar**) eller med `aihummer settings set`. `gateway.env` är endast för bootstrap och ignoreras för dessa nycklar. För den värdbaserade installationen är röstsidobilarna (STT/TTS) konfigurerade åt dig; webbsökningen och webbläsaren kopplas av själva installationsprogrammet — du anger aldrig deras adresser och de visas inte bland inställningarna; resten aktiverar du vid behov. ```bash # 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] > Eftersom varje sidovagn bara är en URL, kan du centralisera tunga tjänster. Rikta > flera gateways mot en delad STT/TTS-instans istället för att köra en kopia per > värd; för sökningen och webbläsaren gör installationsflaggorna `--external-search=URL` > och `--external-browser=URL` samma sak. ## Kör dem lokalt eller delat Varje sidovagn körs under sin egen systemd-enhet på värddatorn, så du hanterar den som vilken annan tjänst som helst — starta, stoppa och läs loggar oberoende av gatewayen. Om du redan kör, säg, en SearXNG- eller en Chrome/CDP-endpoint, ge installationsprogrammet `--external-search=URL` eller `--external-browser=URL`: ingen lokal kopia installeras och gatewayen anropar din instans i stället. För röst och video riktar du motsvarande inställning mot den befintliga instansen. Hur som helst är gatewayens vy identisk: en konfigurerad URL som den kan anropa. > [!WARNING] > Den `browser` (CDP) och `web_search` verktyg når ut till nätverket. På > granskning av hårdnade eller luftspärrade distributioner utgående trafik och inställningen för luftspärr > innan du aktiverar dem — gatewayen anropar bara en sidovagn som du har kopplat. ## Vart härnäst - Hur röst och webbläsarverktyget används i en tur: [Gateway- och turbinmotor](/sv/v1.0/architecture/gateway-turn-engine). - Det minimala hårda beroendet (PostgreSQL) och allt annat som valfritt: [Gateway- och turbinmotor](/sv/v1.0/architecture/gateway-turn-engine).