Sidecars

# 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

Einige Funktionen — Sprache, Video, Websuche, ein kopfloser Browser — sind nicht Teil des Gateways selbst. Sie laufen als **Sidecars**: kleine, unabhängige HTTP-Dienste, die das Gateway erreicht **über URL**. Jedes Sidecar **kostenlos und lokal**: hinter keinem von ihnen steht eine verpflichtende kostenpflichtige API. ## Was ein Sidecar ist Ein Sidecar ist ein separater Prozess, der eine HTTP-API bereitstellt. Das Gateway bindet es nie ein oder führt es im Prozess aus – es ruft einfach die von Ihnen konfigurierte URL auf. Jeder Sidecar - läuft unter **seine eigene systemd-Einheit** (host-nativ, keine Container), - ist über eine Umgebungsvariable mit dem Gateway verbunden, und - kann sein **nativ neben dem Gateway installiert oder auf ein vorhandenes gerichtet Instanz** du läufst schon woanders. Da der Vertrag nur HTTP ist, funktioniert dieselbe Konfiguration, unabhängig davon, ob der Sidecar aktiviert ist. `localhost` oder auf einem anderen Host. > [!NOTE] > Sidecars sind optional — mit einer Ausnahme: Die Websuche (SearXNG) und der > Anti-Detect-Browser (CloakBrowser) werden ab Werk installiert. Ihre Nutzlasten > reisen im signierten Installer-Bündel mit und werden offline installiert. > Schalten Sie sie mit den Installer-Flags `--no-search` und `--no-browser` ab. > Jede andere Funktion ist nur dann aktiv, wenn ihre URL konfiguriert ist; eine > minimale Installation ist weiterhin nur das Gateway plus PostgreSQL. ## Die Sidecars und ihre Ports | Port | Sidecar | Unterstützt von | Mächte | Verdrahtet mit | |---|---|---|---|---| | 8001 | STT | schneller flüstern | Sprache-zu-Text | `AIHUMMER_STT_URL` | | 8002 | TTS | edge-tts | Text-zu-Sprache | `AIHUMMER_TTS_URL` | | 8005 | Video | ffmpeg | Videoverständnis | `AIHUMMER_VIDEO_URL` | | 8888 | SearXNG | SearXNG | der `web_search` Werkzeug | vom Installer installiert, Einstellung verborgen; externe Instanz — `--external-search=URL` | | 9222 | Chrome / CDP | Chrome (CDP) | der `browser` Werkzeug | vom Installer installiert, Einstellung verborgen; externe Instanz — `--external-browser=URL` | Die Sprach-Sidecars sind der sofort einsatzbereite Pfad: STT (`:8001`) speist den Agenten-Durchgang und TTS (`:8002`) spricht die Antwort, sowohl auf freien/lokalen Engines. Videoverstehen (`:8005`) ist ein zusätzliches, optionales Sidecar. SearXNG (`:8888`) Rücken `web_search`, und ein Chrome/CDP-Endpunkt (`:9222`) unterstützt die `browser` Werkzeug. ## Verdrahten von Sidecars Sie richten das Gateway auf jedes Sidecar mit dem passenden aus **Katalogeinstellung** — aus der Admin-Benutzeroberfläche (**Management → Einstellungen**) oder mit `aihummer settings set`. `gateway.env` ist nur für Bootstrap und wird für diese Schlüssel ignoriert. Bei der Host-nativen Installation werden die Sprach-Sidecars (STT/TTS) für Sie konfiguriert; Websuche und Browser verdrahtet der Installer selbst — Sie setzen ihre Adressen nie und sie erscheinen nicht in den Einstellungen; den Rest aktivieren Sie nach Bedarf. ```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] > Da jedes Sidecar nur eine URL ist, können Sie schwere Dienste zentralisieren. Richten > Sie mehrere Gateways auf eine gemeinsame STT/TTS-Instanz, statt pro Host eine Kopie > zu betreiben; für Suche und Browser leisten die Installer-Flags > `--external-search=URL` und `--external-browser=URL` dasselbe. ## Sie nativ oder gemeinsam ausführen Jedes Sidecar läuft unter seiner eigenen systemd-Einheit auf dem Host, sodass Sie es wie jeden anderen Dienst betreiben können — unabhängig vom Gateway starten, stoppen und Protokolle lesen. Wenn Sie bereits beispielsweise eine SearXNG- oder eine Chrome/CDP-Instanz betreiben, übergeben Sie dem Installer `--external-search=URL` oder `--external-browser=URL`: Es wird keine lokale Kopie installiert und das Gateway ruft stattdessen Ihre Instanz auf. Für Sprache und Video richten Sie die passende Einstellung auf die vorhandene Instanz. So oder so ist die Sicht des Gateways identisch: eine konfigurierte URL, die es aufrufen kann. > [!WARNING] > Der `browser` (CDP) und `web_search` Werkzeuge greifen auf das Netzwerk zu. Ein > Überprüfung von gehärteten oder luftdicht getrennten Bereitstellungen, des Austritts und der luftdicht getrennten Einstellung > bevor Sie sie aktivieren — das Gateway ruft nur einen Sidecar auf, den Sie angeschlossen haben. ## Wohin als Nächstes - Wie Stimme und das Browser-Tool in einer Runde verwendet werden: [Gateway- und Drehmotor](/de/v1.0/architecture/gateway-turn-engine). - Die minimale harte Abhängigkeit (PostgreSQL) und alles andere optional: [Gateway- und Drehmotor](/de/v1.0/architecture/gateway-turn-engine).