OpenSwarm : Orchestrateur CLI Multi-Agents Claude pour Linear et GitHub

Ce que fait OpenSwarm

OpenSwarm est un orchestrateur d'agents IA autonomes alimenté par Claude Code CLI. Il crée un système multi-agents qui s'intègre aux flux de travail de développement réels, spécifiquement Linear pour le suivi des problèmes et GitHub pour la gestion du code. L'outil est conçu pour gérer des tâches de développement réelles plutôt que des exemples simplifiés.

Architecture et fonctionnalités principales

Le système suit une approche de pipeline structurée :

• Pipeline autonome : Un battement de cœur piloté par Cron récupère les problèmes Linear et exécute des boucles de paires Worker/Reviewer
• Paires Worker/Reviewer : Génération de code multi-itérations avec des étapes automatisées de revue, de test et de documentation
• Moteur de décision : Validation de la portée, limitation du débit, sélection des tâches basée sur la priorité et cartographie des flux de travail
• Mémoire cognitive : Base de données vectorielle LanceDB avec des embeddings Xenova/multilingual-e5-base pour la mémorisation à long terme entre les sessions
• Graphe de connaissances : Analyse statique du code, cartographie des dépendances et analyse d'impact pour une exécution plus intelligente des tâches
• Contrôle Discord : Interface de commande complète pour la surveillance, la distribution des tâches, la planification et la gestion des sessions en paires
• Amélioration automatique des PR : Surveille les PR ouvertes, corrige automatiquement les échecs CI, résout automatiquement les conflits de fusion et réessaie jusqu'à ce que tous les contrôles passent
• Moniteurs de longue durée : Suit les processus externes (travaux d'entraînement, tâches par lots) et signale leur achèvement
• Tableau de bord web : Tableau de bord de statut en temps réel sur le port 3847 avec surveillance du processeur PR
• Support i18n : Prise en charge des langues anglaise et coréenne

Exigences techniques

• Node.js >= 22
• Claude Code CLI installé et authentifié (claude -p)
• Jeton de bot Discord avec intention de contenu de message
• Clé API Linear et ID d'équipe
• CLI GitHub (gh) pour la surveillance CI (optionnel)

Installation et configuration

Configuration de base :

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

La configuration implique de copier l'exemple de configuration et de créer un fichier .env :

cp config.example.yaml config.yaml

Variables .env requises :

DISCORD_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=your-channel-id
LINEAR_API_KEY=your-linear-api-key
LINEAR_TEAM_ID=your-linear-team-id

Le config.yaml prend en charge la substitution des variables d'environnement (${VAR} ou ${VAR:-default}) et est validé avec des schémas Zod. Les sections de configuration clés incluent les paramètres discord, linear, github, agents, autonomous et prProcessor.

Statut actuel et limitations

Le créateur note qu'il s'agit encore d'un logiciel précoce avec des imperfections. Les TODOs actuels se concentrent sur la sécurité, la mise à l'échelle et une meilleure décomposition des tâches. Le système alimente actuellement le flux de travail de développement solo du créateur pour l'infrastructure de trading, les outils LLM et d'autres projets.