ferngeist-acp-gateway
Servidor de gateway autocontenido para agentes compatibles con ACP, que expone una API WebSocket unificada y resiliente.
Ficha actualizada 23 sept 2026, 11:34 · upstream 23 sept 2026, 11:32 · release v0.11.1
Qué es ferngeist-acp-gateway
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
# Ferngeist Gateway
Ferngeist Gateway es un servidor backend autocontenido diseñado para conectar agentes compatibles con ACP a través de una API WebSocket unificada. Su propósito principal es exponer los agentes de forma centralizada, proporcionando sesiones resistentes a la desconexión que mantienen activos a los agentes incluso cuando el WebSocket se disocia.
## Instalación y Construcción
El servicio puede instalarse mediante comandos simples según el sistema operativo: - **macOS + Linux:** Un solo comando `curl` con un script de instalación automático. - **Windows:** Un script PowerShell que ejecuta la instalación automáticamente.
O se puede descargar manualmente desde las páginas de releases de GitHub. Si se desea construir desde fuente, se requiere Go y se ejecutan comandos de compilación específicos que generan el binario `ferngeist-gateway`.
## Uso Local
El daemon se ejecuta en la misma máquina donde se alojan los agentes: - Se puede ejecutar con modo remoto (`--remote`) para obtener una URL pública estable mediante Tailscale. - Se puede ejecutar localmente en red local (`--lan`) para acceso interno.
Para emparejar un dispositivo, se ejecuta el comando `ferngeist-gateway pair` desde la máquina que contiene el daemon. El servicio también permite inspeccionar archivos y estado de git del agente a través de endpoints públicos.
## Exposición Remota
El gateway soporta múltiples métodos para exponerse a internet: - **Tailscale:** Se emite un nodo Tailscale que provisiona Funnel, proporcionando una URL pública estable (`https://<machine>.<tailnet>.ts.net`) que nunca cambia entre reinicios. - **Cloudflare Tunnel:** Se puede usar Cloudflare Tunnel para exponer el servicio sin necesidad de configurar HTTPS manualmente. - **Proxy Reverse:** Se puede instalar un proxy como Nginx o similar y apuntar al puerto 5788 del gateway.
## Documentación
El proyecto incluye documentación completa en formato Markdown, incluyendo instrucciones por sistema operativo, arquitectura, API pública e interna, seguridad, flujo de emparejamiento, acceso remoto, configuración y desarrollo.
- Uso relacionado con herramientas de desarrollo
- Uso relacionado con productividad
- Uso relacionado con seguridad
- La información técnica es una estimación automática y debe validarse antes de un despliegue de producción.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Revisar la documentación oficial, persistencia de datos, secretos, copias de seguridad y proxy HTTPS antes de producción.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.