agentpod
Consola centralizada para gestionar flotas de agentes de IA (OpenCode, Claude Code, etc.) mediante un hub en Bun/Go, consola SvelteKit y nodos Go que se ejecutan en cada host.
Ficha actualizada 22 sept 2026, 17:27 · upstream 22 sept 2026, 17:24 · release v0.1.62
Qué es agentpod
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
AgentPod es una plataforma de gestión de runtimes diseñada para operar múltiples máquinas y workspaces donde residen los agentes de IA. El sistema consta de tres componentes principales: el hub central (escrito en Bun con Hono, Drizzle y PostgreSQL + pgvector) que actúa como registro, broker y punto de autenticación; la consola frontend (SvelteKit 5) para visualizar el roster de nodos, archivos, logs y gestionar accesos; y los agentes nodales (Go daemon) que se ejecutan en cada host para detectar harnesses y conectarse al hub mediante conexiones WSS salientes.
La arquitectura permite operar máquinas detrás de NAT sin necesidad de abrir puertos entrantes, ya que cada nodo establece una conexión outbound hacia el hub. El sistema soporta integraciones con herramientas como Hermes, OpenClaw, Claude Code y Pi a través de descripciones específicas por harness. La gestión de identidad se realiza mediante principios (principals) y asignación de permisos de despliegue, con soporte opcional para integraciones con Matrix y Superpipeline para orquestación de trabajo.
El despliegue requiere Bun, Node.js 20+, pnpm 10.18.2 y una base de datos PostgreSQL con pgvector. Las binarias precompiladas están disponibles para Linux y macOS (amd64/arm64). La consola se construye estáticamente embebiendo la URL del hub en el momento de compilación, lo que requiere un proceso de build separado antes de servir en un dominio personalizado.
- Gestión unificada de múltiples agentes de IA (Claude Code, OpenCode, etc.) desde una única consola web
- Provisionamiento y supervisión de nuevos entornos de trabajo para agentes sin abrir puertos entrantes
- Actualización controlada de nodos individuales o de flota completa mediante comandos CLI (apn update)
- Auditoría centralizada de logs, archivos y estado de salud de todos los nodos en la flota
- Arquitectura outbound-only: nodos conectan al hub vía WSS sin necesidad de puertos entrantes abiertos
- Soporte multi-harness con detección automática de estaciones (Hermes, OpenClaw, Claude Code, Pi)
- Gestión de identidad y acceso mediante principios (principals) y asignación granular de permisos
- Binarias precompiladas disponibles para Linux y macOS sin necesidad de compilar desde fuente en producción
- Requiere PostgreSQL con extensión pgvector, lo que limita el despliegue en entornos sin esta tecnología específica
- No incluye Docker ni Dockerfile nativo, necesitando instalación manual del entorno Go y Bun para desarrollo
- La consola está embebida al momento de la compilación con la URL del hub, limitando la flexibilidad de despliegue dinámico
- Soporta actualmente un único tenant bootstrap, sin gestión independiente de organizaciones multi-tenant
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.
Utilizar binarias precompiladas para producción en lugar de construir desde fuente. Configurar DATABASE_URL con conexión a PostgreSQL + pgvector. Construir la consola estáticamente embebendo la URL del hub antes de servir en un dominio personalizado. Gestionar manualmente tokens de inscripción y variables de entorno de seguridad (origins, cookies).
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.