AiHummer
Español▾
Iniciar sesiónCuenta
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Arquitectura/Sidecares

Sidecares

v1.1.x · actualizada 2026-07-05

Algunas capacidades — habla, video, búsqueda en la web, un navegador sin cabeza — no forman parte del propio gateway. Funcionan como sidecares: pequeños servicios HTTP independientes a los que llega el gateway por URL. Cada sidecar es gratis y local: no hay ninguna API de pago obligatoria detrás de ninguna de ellas.

Qué es un sidecar

Un sidecar es un proceso separado que expone una API HTTP. La puerta de enlace nunca lo enlaza ni lo ejecuta en el proceso, simplemente llama a la URL que configuras. Cada sidecar

  • funciona bajo su propia unidad systemd (nativo del host, sin contenedores),
  • está conectado al gateway a través de una variable de entorno, y
  • puede ser instalado de forma nativa junto a la puerta de enlace, o apuntando a un existente instancia ya corres en otro lugar.

Debido a que el contrato es solo HTTP, la misma configuración funciona tanto si el sidecar está activado localhost o en otro anfitrión.

[!NOTE] Los sidecars son opcionales — con una excepción: la búsqueda web (SearXNG) y el navegador antidetección (CloakBrowser) se instalan de fábrica. Sus cargas viajan dentro del paquete firmado del instalador y se instalan sin conexión. Desactívalos con las banderas del instalador --no-search y --no-browser. Cualquier otra capacidad solo está activa cuando su URL está configurada; una instalación mínima sigue siendo solo la puerta de enlace más PostgreSQL.

Los sidecares y sus puertos

Puerto Sidecar Respaldado por Poderes Conectado con
8001 STT susurro más rápido voz a texto AIHUMMER_STT_URL
8002 TTS edge-tts texto a voz AIHUMMER_TTS_URL
8005 video ffmpeg comprensión de video AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG la web_search herramienta lo instala el instalador, ajuste oculto; instancia externa — --external-search=URL
9222 Chrome / CDP Chrome (CDP) la browser herramienta lo instala el instalador, ajuste oculto; instancia externa — --external-browser=URL

Los sidecars de voz son la ruta lista para usar: STT (:8001) alimenta el turno del agente y TTS (:8002) habla la respuesta, tanto en motores gratuitos/locales. Comprensión de video (:8005) es un sidecar adicional, opcional. SearXNG (:8888) espaldas web_search, y un endpoint de Chrome/CDP (:9222) respalda el browser herramienta.

Cableado de sidecars

Apuntas la puerta de enlace a cada sidecar con la correspondiente configuración del catálogo — desde la interfaz de administración (Gestión → Configuración) o con aihummer settings set. gateway.env es solo de bootstrap y se ignora para estas claves. Para la instalación nativa en el host, los voice sidecars (STT/TTS) se configuran para usted; la búsqueda web y el navegador los cablea el propio instalador — nunca configuras sus direcciones y no se muestran en los ajustes; el resto lo activa según sea necesario.

# 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] Porque cada sidecar es solo una URL, puedes centralizar servicios pesados. Apunta varias pasarelas a una instancia compartida de STT/TTS en lugar de ejecutar una copia por anfitrión; para la búsqueda y el navegador, las banderas del instalador --external-search=URL y --external-browser=URL hacen lo mismo.

Ejecutándolos de forma nativa o compartida

Cada sidecar vive bajo su propia unidad systemd en el host, por lo que lo operas como cualquier otro servicio: iniciar, detener y leer los registros de manera independiente del gateway. Si ya ejecutas, por ejemplo, un punto final de SearXNG o de Chrome/CDP, pásale al instalador --external-search=URL o --external-browser=URL: no se instala ninguna copia local y la puerta de enlace llama a tu instancia en su lugar. Para voz y video, apunta el ajuste correspondiente a la instancia existente. De cualquier manera, la vista del gateway es idéntica: una URL configurada a la que puede llamar.

[!WARNING] la browser (CDP) y web_search las herramientas se comunican con la red. Encendido revisión de despliegues endurecidos o aislados del aire, el flujo de salida y la configuración aislada del aire antes de habilitarlos — la puerta de enlace solo llama a un sidecar que has conectado.

¿A dónde vamos ahora?