OpenSwarm: Orquestrador CLI Multi-Agente de Claude

Qué hace OpenSwarm

OpenSwarm es un orquestador de agentes de IA autónomos impulsado por Claude Code CLI. Crea un sistema multiagente que se integra con flujos de trabajo de desarrollo reales, específicamente Linear para el seguimiento de problemas y GitHub para la gestión de código. La herramienta está diseñada para manejar tareas de desarrollo reales en lugar de ejemplos simples.

Arquitectura central y características

El sistema sigue un enfoque de pipeline estructurado:

Pipeline autónomo: Latido cron que obtiene problemas de Linear y ejecuta bucles de pares Trabajador/Revisor
Pares Trabajador/Revisor: Generación de código multi-iteración con etapas automatizadas de revisión, prueba y documentación
Motor de decisión: Validación de alcance, limitación de tasa, selección de tareas basada en prioridad y mapeo de flujo de trabajo
Memoria cognitiva: Almacén vectorial LanceDB con incrustaciones Xenova/multilingual-e5-base para recuerdo a largo plazo entre sesiones
Grafo de conocimiento: Análisis estático de código, mapeo de dependencias y análisis de impacto para una ejecución de tareas más inteligente
Control de Discord: Interfaz de comando completa para monitoreo, despacho de tareas, programación y gestión de sesiones de pares
Mejora automática de PR: Monitorea PRs abiertos, corrige automáticamente fallos de CI, resuelve automáticamente conflictos de fusión y reintenta hasta que pasen todas las verificaciones
Monitores de larga duración: Rastrea procesos externos (trabajos de entrenamiento, tareas por lotes) e informa la finalización
Panel web: Panel de estado en tiempo real en el puerto 3847 con monitoreo del Procesador de PR
Soporte i18n: Soporte para localizaciones en inglés y coreano

Requisitos técnicos

Node.js >= 22
Claude Code CLI instalado y autenticado (claude -p)
Token de bot de Discord con intención de contenido de mensaje
Clave API de Linear e ID de equipo
CLI de GitHub (gh) para monitoreo de CI (opcional)

Instalación y configuración

Configuración básica:

git clone https://github.com/unohee/OpenSwarm.git
cd OpenSwarm
npm install

La configuración implica copiar la configuración de ejemplo y crear un archivo .env:

cp config.example.yaml config.yaml

Variables .env requeridas:

DISCORD_TOKEN=tu-token-de-bot-discord
DISCORD_CHANNEL_ID=tu-id-de-canal
LINEAR_API_KEY=tu-clave-api-linear
LINEAR_TEAM_ID=tu-id-de-equipo-linear

El config.yaml admite sustitución de variables de entorno (${VAR} o ${VAR:-default}) y se valida con esquemas Zod. Las secciones clave de configuración incluyen ajustes de discord, linear, github, agents, autonomous y prProcessor.

Estado actual y limitaciones

El creador señala que este es todavía software temprano con imperfecciones. Los TODOs actuales se centran en seguridad, escalabilidad y mejor descomposición de tareas. El sistema actualmente impulsa el flujo de trabajo de desarrollo en solitario del creador para infraestructura de trading, herramientas LLM y otros proyectos.

📖 Leer la fuente completa: HN AI Agents