Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

robotina

Robotina es un agente autónomo self-hosted en un único contenedor Docker, supervisado por s6, con Hermes (Telegram), opencode serve (loopback) y engram (memoria). Seguridad mediante proxy Squid con allowlist de dominios, sin puertos publicados.

Ficha actualizada 28 sept 2026, 0:11 · upstream 28 sept 2026, 0:01 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es robotina

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Robotina implementa una arquitectura de agente autónomo contenida en un solo contenedor Docker que ejecuta tres componentes principales: Hermes para la comunicación vía Telegram, opencode serve como servidor local de código (solo loopback) y engram para gestión de memoria. El sistema utiliza s6 como supervisor de procesos, lo que garantiza una gestión robusta de los servicios internos.

La seguridad es un pilar fundamental del diseño, implementando estrictamente el control de salida de tráfico a través de un proxy Squid configurado con allowlist de dominios específicos (.telegram.org, .opencode.ai, .github.com, etc.). Esto elimina la necesidad de puertos publicados en el host, reduciendo la superficie de ataque y permitiendo una implementación segura en entornos restringidos.

El repositorio incluye herramientas para migración de estado desde versiones anteriores, gestión de tokens de GitHub para clonación de repositorios privados, y configuración flexible de modelos de IA a través de variables de entorno. La arquitectura permite delegar tareas complejas entre Hermes y el servidor local de OpenCode dentro del mismo espacio aislado.

CASOS DE USO
  • Asistente autónomo de desarrollo en Telegram para refactorización de código local sin exponer datos al internet público
  • Agente de gestión de repositorios privados con autenticación mediante tokens GitHub PAT fine-grained
  • Sistema de memoria persistente para agentes de IA que mantiene contexto a largo plazo en entornos self-hosted
  • Plataforma de desarrollo seguro para empresas con políticas estrictas de egress controlado por proxy
PUNTOS DESTACADOS
  • Arquitectura monolítica contenida que simplifica el despliegue y reduce la complejidad operativa
  • Control estricto de egress mediante proxy Squid con allowlist, cumpliendo políticas de seguridad corporativa
  • Sin puertos publicados en el host, eliminando vectores de ataque comunes en contenedores expuestos
  • Soporte nativo para bind mounts de Windows y Linux, facilitando la portabilidad entre plataformas
PRECAUCIONES
  • El servidor de OpenCode solo escucha en loopback (127.0.0.1:4096), requiriendo ejecución dentro del contenedor para inspección
  • Los tokens de GitHub y credenciales de modelos residen en el mismo contenedor, aumentando la superficie de riesgo si no se gestionan adecuadamente
  • Requiere configuración manual de allowlist en Squid para nuevos dominios de proveedores de IA alternativos
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Requiere Docker Compose v2 y bind mounts configurados en el host para persistencia de datos. Es fundamental configurar las variables ROBOTINA_TELEGRAM_BOT_TOKEN, ROBOTINA_HERMES_MODEL_KEY y ROBOTINA_OPENCODE_MODEL_KEY en el archivo .env antes del arranque. El build inicial requiere conexión a internet sin pasar por Squid. Para producción, se recomienda establecer ROBOTINA_GITHUB_TOKEN con PAT fine-grained para acceso a repositorios privados.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsGoPython
SERVICIOS
S3/MinIO
BASES DE DATOS
No detectadas
PUERTOS
4096
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.