Side-cars

# 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

Certaines capacités — la parole, la vidéo, la recherche sur le web, un navigateur sans interface — ne font pas partie de la passerelle elle-même. Elles fonctionnent comme **side-cars**: petits services HTTP indépendants que la passerelle atteint **par URL**. Chaque side-car est **gratuit et local**: il n'y a pas d'API payante obligatoire derrière aucune d'entre elles. ## Qu'est-ce qu'un side-car Un sidecar est un processus séparé exposant une API HTTP. La passerelle ne le lie jamais ni ne l'exécute en processus — elle se contente d'appeler l'URL que vous configurez. Chaque sidecar - fonctionne sous **sa propre unité systemd** (natif hôte, sans conteneurs), - est câblé au portail via une variable d'environnement, et - peut être **installé nativement à côté de la passerelle, ou pointé vers un existant instance** tu cours déjà ailleurs. Parce que le contrat est juste HTTP, la même configuration fonctionne que le sidecar soit activé ou non `localhost` ou sur un autre hôte. > [!NOTE] > Les sidecars sont facultatifs — à une exception près : la recherche web (SearXNG) > et le navigateur anti-détection (CloakBrowser) sont installés d'origine. Leurs > charges voyagent dans le paquet signé de l'installateur et s'installent hors ligne. > Désactivez-les avec les drapeaux d'installation `--no-search` et `--no-browser`. > Toute autre fonctionnalité n'est active que lorsque son URL est configurée ; une > installation minimale reste juste la passerelle plus PostgreSQL. ## Les side-cars et leurs ports | Port | Side-car | Soutenu par | Pouvoirs | Câblé avec | |---|---|---|---|---| | 8001 | STT | chuchotement-plus-rapide | reconnaissance vocale | `AIHUMMER_STT_URL` | | 8002 | TTS | edge-tts | texte en parole | `AIHUMMER_TTS_URL` | | 8005 | vidéo | ffmpeg | compréhension de la vidéo | `AIHUMMER_VIDEO_URL` | | 8888 | SearXNG | SearXNG | le `web_search` outil | installé par l'installateur, réglage masqué ; instance externe — `--external-search=URL` | | 9222 | Chrome / CDP | Chrome (CDP) | le `browser` outil | installé par l'installateur, réglage masqué ; instance externe — `--external-browser=URL` | Les sidecars vocaux sont le chemin prêt à l'emploi : STT (`:8001`) alimente le tour de l'agent et la synthèse vocale (TTS)`:8002`) prononce la réponse, à la fois sur les moteurs gratuits/locaux. Compréhension vidéo (`:8005`) est un sidecar supplémentaire, facultatif. SearXNG (`:8888`) dos `web_search`, et un point de terminaison Chrome/CDP (`:9222`) soutient le `browser` outil. ## Câblage des side-cars Vous dirigez la passerelle vers chaque side-car avec le correspondant **paramètre de catalogue** — depuis l'interface d'administration (**Gestion → Paramètres**) ou avec `aihummer settings set`. `gateway.env` est uniquement bootstrap et est ignoré pour ces clés. Pour l'installation native sur l'hôte, les voix secondaires (STT/TTS) sont configurées pour vous ; la recherche web et le navigateur sont câblés par l'installateur lui-même — vous ne définissez jamais leurs adresses et ils n'apparaissent pas dans les paramètres ; le reste vous l'activez selon vos besoins. ```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] > Parce que chaque sidecar n'est qu'une URL, vous pouvez centraliser les services lourds. Pointez > plusieurs passerelles sur une instance STT/TTS partagée au lieu d'en faire fonctionner une > copie par hôte ; pour la recherche et le navigateur, les drapeaux d'installation > `--external-search=URL` et `--external-browser=URL` font la même chose. ## Les exécuter nativement ou de manière partagée Chaque sidecar fonctionne sous sa propre unité systemd sur l'hôte, donc vous le gérez comme n'importe quel autre service — démarrez, arrêtez et lisez les journaux indépendamment de la passerelle. Si vous exécutez déjà, par exemple, une instance SearXNG ou un endpoint Chrome/CDP, passez à l'installateur `--external-search=URL` ou `--external-browser=URL` : aucune copie locale n'est installée et la passerelle appelle votre instance à la place. Pour la voix et la vidéo, pointez le paramètre correspondant vers l'instance existante. Dans les deux cas, la vue de la passerelle est identique : une URL configurée qu'elle peut appeler. > [!WARNING] > Le `browser` (CDP) et `web_search` les outils se connectent au réseau. Sur > examen des déploiements durcis ou en réseau isolé, de la sortie et du paramètre de réseau isolé > avant de les activer — la passerelle appelle uniquement un sidecar que vous avez connecté. ## Où aller ensuite - Comment la voix et l'outil de navigateur sont utilisés dans un tour : [Passerelle et moteur de rotation](/fr/v1.0/architecture/gateway-turn-engine). - La dépendance minimale obligatoire (PostgreSQL) et tout le reste en option : [Passerelle et moteur de rotation](/fr/v1.0/architecture/gateway-turn-engine).