Cordane — Hub para Agentes de IA Autoalojable
¿Qué es Cordane?
Cordane es una plataforma de control centralizado para gestionar equipos de desarrollo y agentes de inteligencia artificial ejecutándose en hardware propio. Funciona como un hub que orquesta múltiples workers distribuidos, permitiendo operar desde cualquier lugar sin exponer puertos entrantes ni configurar VPNs.
Casos de Uso
- Gestionar agentes de IA (Claude Code, Codex, Opencode) en hardware propio sin exponer puertos
- Orquestar worktrees de Git y servidores de desarrollo desde un tablero Kanban centralizado
- Acceder a terminales persistentes con PTY real desde cualquier navegador
- Desplegar previews de aplicaciones locales con subdominios estables sin túneles como ngrok
- Ejecutar tareas programadas en workers remotos sin VPN ni SSH
Arquitectura
Cordane consta de dos componentes separados:
- Hub (Control Plane): La interfaz web que se abre en el navegador. Puede ejecutarse autoalojado o en la nube gestionada.
- Workers (Data Plane): Las máquinas donde los agentes, servidores de desarrollo y código realmente ejecutan. Los workers establecen conexiones WebSocket outbound hacia el hub.
La arquitectura outbound significa que nada conecta hacia los workers — solo se abre una conexión saliente por worker al hub. Esto permite operar desde detrás de NAT, firewalls corporativos o redes air-gapped sin configuración adicional.
Funciones Principales
- Gestión de Tickets Kanban: Tablero compartido con estados: Backlog → Plan → Implementar → Revisar → Done. Cada ticket crea automáticamente un worktree de Git en su propia rama.
- Terminales Persistentes: PTY real que sobrevive a cierres de sesión o reinicios del hub. Mapea sesiones tmux a espacios del tablero.
- Previews de Aplicaciones: Subdominios estables para cada servidor de desarrollo con autenticación por defecto y WebSockets completos.
- Paralelismo Seguro: Cada ticket obtiene su propio worktree y bloque de puertos. Múltiples agentes pueden reconstruir el mismo repositorio simultáneamente sin colisiones.
- Transmisión SSE en Tiempo Real: Movimientos de tarjetas, estados de agentes y eventos de terminal fluyen a todos los miembros del equipo con escopado por equipo.
Requisitos Reales
Hub (Autoalojado)
- Sistema: Linux con Docker o binario Go estático único
- CPU/RAM: ~1 vCPU, 512 MB–1 GB RAM
- Disk: Varios GB
- Red: Puertos 80/443 abiertos para HTTPS automático
- Requisito adicional: App de GitHub OAuth con callback URL configurada
Worker
- Sistema: Linux o macOS
- Requerido: Git (Cordane crea worktrees por ticket)
- Opcional: Docker para agentes en contenedores sandboxeados
- Capacidad: CPU/RAM/disk suficientes para builds y ejecuciones de agentes del proyecto
Instalación y Despliegue
Autoalojado (Community Tier — Gratuito)
# 1. Clonar repositorio
git clone https://github.com/cordane/cordane.git
cd cordane/deploy
# 2. Configurar .env
cp .env.example .env
# Variables clave:
# - EXTERNAL_URL: URL del hub
# - CONTROL_HOST: Hostname del hub
# - CORDANE_SECRET_KEY: openssl rand -base64 32
# - CORDANE_GITHUB_CLIENT_ID/SECRET: App OAuth de GitHub
# 3. Iniciar con Docker Compose
docker compose up -dConectar un Worker
# 1. Obtener token de join desde el hub
curl https://your-hub/install.sh | sh
# 2. Instalar worker en máquina objetivo
cordane worker join https://your-hub --token crdjt_...
# 3. Ejecutar (opcional, para reinicios)
cordane worker runBackup de SQLite
El hub utiliza SQLite para el estado. Backups sencillos vía Litestream hacia buckets S3 compatibles.
Seguridad
- Cifrado AES-256-GCM: Secrets de aplicación y perfil cifrados en la base de datos con clave que el usuario controla — nunca almacenados en texto plano junto a los datos.
- Sin Phone-home: El hub verifica su licencia offline con token firmado. Funciona incluso cuando los servidores de SHB no están disponibles.
- Datos en tu perímetro: En modo cloud gestionado, agentes, fuente y secretos ejecutan solo en workers propios. El plano de datos nunca toca servidores de terceros.
- Autenticación OAuth GitHub: Sin contraseñas. Primer usuario que se autentifica es admin.
- Subdominios autenticados: Previews de aplicaciones con autenticación por defecto y escopado por equipo.
Alternativas Reales
| Herramienta | Diferencia Clave |
|---|---|
| Herdr | Mantiene agentes en terminal. Cordane mantiene agentes en máquina con ticket en tablero desde navegador. |
| Claude Code (nativo) | Terminal local solo, accesible desde navegador sin túnel. Cordane añade tablero Kanban y gestión de múltiples worktrees. |
| tmux + SSH | Requiere puertos abiertos o VPN. Cordane usa arquitectura outbound — nada entra en workers. |
| Coder / Hubcode | Suelen ser cloud-first o requieren túneles. Cordane es nativamente self-hosted con datos en hardware propio. |
Preguntas Frecuentes
¿Qué máquinas pueden ejecutar un worker?
Cualquier sistema Linux o macOS que pueda ejecutar un binario Go. Desde laptop hasta VPS barato ($4-5/mo). Los workers son ligeros y escalables.
¿Cuántos agentes soporta?
Community tier: hasta 3 ejecuciones concurrentes de agente. Tier con licencia: ilimitado. Cada ticket obtiene su propio worktree y puertos.
¿Puedo cambiar entre autoalojado y cloud?
Sí. El único cambio es quién ejecuta el hub (control plane). Workers permanecen en tus máquinas. Puedes mover datos SQLite entre modos sin pérdida.
¿Tengo lock-in con Cordane?
No. Datos son SQLite plano exportable. Hub verifica licencia offline. Puedes migrar entre autoalojado y cloud gestionado libremente.
¿Qué agentes soporta?
Cualquier CLI agent: Claude Code, Codex, Aider o scripts propios. No estás lockeado a un modelo o proveedor específico.
Precios
- Community (Gratuito): 1 worker, 1 proyecto, 2 usuarios, 3 concurrentes. Sin licencia, sin phone-home.
- Self-hosted con Licencia: $19/user/mo. Ilimitado en workers, proyectos y concurrencia.
- Cloud Gestionado: $39/mo + 3 seats. Hub ejecutado por SHB con TLS, backups y upgrades automáticos.