Modèle / jeu de données
ruvnet/ruflo avatar
ruvnet/ruflo

Ruflo : orchestrer des agents depuis un projet Rust et JavaScript

Ruflo est un méta-harnais d'agents pour Claude Code et Codex, ajoutant plus de 100 agents spécialisés, des essaims coordonnés, une mémoire auto-apprenante et la fédération entre machines.

72 427 étoiles8 572 forksTypeScriptMIT

En bref

De quoi s’agit-il ?
Ruflo se présente comme un méta-harnais d'agents : une couche d'exécution qui ajoute des agents, de la mémoire, de la coordination et de la fédération à Claude Code et Codex.
À qui s’adresse-t-il ?
Pour ruflo, le choix convient aux équipes dont le besoin correspond aux fonctions décrites dans le README et qui peuvent contrôler leur environnement d’exécution. Il convient moins à celles qui attendent une garantie absente de la documentation.
Puis-je l’utiliser commercialement ?
Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
Est-il encore maintenu ?
Oui. Les derniers commits datent d’il y a 1 jour.
En quel langage est-il écrit ?
Principalement TypeScript, d’après les statistiques de langage de GitHub.

Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.

ANALYSE OPEN SOURCE APPROFONDIE

Le concept de harnais

Le README commence par une formule : Agent = Modèle + Harnais. Le modèle écrit, et le harnais fournit outils, mémoire, boucles, sandbox et contrôles. Ruflo est positionné comme ce harnais, une couche d'exécution autour de Claude Code et Codex qui ajoute plus de 100 agents spécialisés, des essaims coordonnés, une mémoire auto-apprenante, des communications fédérées entre machines et ce qu'il appelle des garde-fous de sécurité d'entreprise. L'objectif annoncé est que les agents ne se contentent pas de s'exécuter, mais collaborent. Le README précise aussi qu'après l'initialisation, les utilisateurs peuvent continuer à utiliser Claude Code normalement, car un système de hooks achemine les tâches et coordonne les agents en arrière-plan.

Deux chemins d'installation aux surfaces différentes

Ruflo documente deux chemins d'installation. Le chemin A est une installation de plugin Claude Code : ajouter le marché avec /plugin marketplace add ruvnet/ruflo, puis installer des plugins comme ruflo-core et ruflo-swarm. Ce chemin n'ajoute que des commandes slash et des définitions d'agents, et n'enregistre pas le serveur MCP, donc des outils comme memory_store et swarm_init ne sont pas appelables. Le chemin B est l'installation CLI avec npx ruflo init (ou npx ruflo@latest init wizard pour un assistant interactif), qui crée les répertoires .claude et .claude-flow, installe les hooks, enregistre le serveur MCP et fournit la boucle complète avec 98 agents, plus de 60 commandes, 30 compétences et un démon. Le README avertit que la commande curl | bash nécessite un shell POSIX, tandis que l'assistant npx fonctionne nativement sous Windows PowerShell et cmd.

Marché de plugins et surface de capacités

Le dépôt liste 35 plugins dans des catégories comme orchestration de base, mémoire et connaissance, intelligence et apprentissage, qualité de code et tests, sécurité et conformité, architecture et méthodologie, DevOps et observabilité, extensibilité, et outils spécifiques au domaine. Parmi les entrées notables : ruflo-swarm pour coordonner les agents, ruflo-rag-memory pour la recherche hybride, ruflo-aidefence pour bloquer l'injection de prompt, et ruflo-metaharness pour auditer une configuration d'agents. Le tableau des capacités du README revendique également plus de 100 agents, 12 workers de fond déclenchés automatiquement, un marché avec 33 plugins Claude Code natifs et 21 plugins npm, et un support multi-fournisseurs pour Claude, GPT, Gemini, Cohere et Ollama. Ce sont des affirmations du README, pas des mesures indépendantes.

Architecture et boucle d'auto-apprentissage

Le diagramme d'architecture du README part de l'utilisateur, traverse la couche d'orchestration (serveur MCP, routeur, 27 hooks), puis la coordination d'essaim (reine, topologie, consensus), ensuite plus de 100 agents spécialisés, puis la mémoire et l'apprentissage (AgentDB, HNSW, SONA, ReasoningBank), et enfin les fournisseurs de LLM. Un autre diagramme montre l'utilisateur entrant via CLI ou MCP, un routeur dispatchant vers un essaim, les agents agissant, la mémoire mise à jour, et une boucle d'apprentissage renvoyant au routeur. Pour la mémoire vectorielle, le README cite des mesures d'environ 1,9x plus rapide à N=20k et 3,2x à 4,7x à N=5k par rapport à la force brute, avec recall@10 autour de 0,99, et renvoie à un document d'audit et à un script de benchmark. Le tableau comparatif mentionne aussi une précision de 89% pour le routage intelligent, sans expliquer le protocole de test.

Fédération d'agents au-delà des frontières de confiance

La section fédération décrit comment des agents sur différentes machines forment des espaces de travail partagés. Le README l'appelle 'Slack pour agents' et dit que les agents distants commencent non fiables, puis prouvent leur identité via mTLS et défi-réponse ed25519. Un pipeline de détection PII supprime les e-mails, SSN et clés des messages sortants, et des politiques par niveau de confiance peuvent BLOCKER, RÉDIGER, HACHER ou LAISSER PASSER. Le score de confiance repose sur une formule (0,4x succès, 0,2x disponibilité, 0,2x menace, 0,2x intégrité), les montées exigent de l'historique, les descentes sont immédiates. La section liste 9 outils MCP et 10 commandes CLI ; les exemples utilisent npx claude-flow@latest federation init, join, send et status. Le README renvoie à l'issue #1669 pour l'architecture complète et la feuille de route, ainsi qu'à un guide utilisateur de fédération.

Deux interfaces hébergées : Web UI et planificateur d'objectifs

Le README de Ruflo documente deux applications Web hébergées. La première est une version bêta d'interface Web sur flo.ruv.io, décrite comme un chat multi-modèles avec appels d'outils MCP intégrés. Elle prend en charge six modèles choisis, dont Qwen, Claude, Gemini et OpenAI via OpenRouter, peut appeler environ 210 outils répartis en cinq groupes de serveurs, exécute les outils en parallèle et dispose d'une mémoire vectorielle persistante avec AgentDB et HNSW. Elle est auto-hébergeable via un Dockerfile avec MongoDB embarqué. La seconde est un planificateur d'objectifs sur goal.ruv.io, qui transforme des objectifs en langage naturel en plans exécutables grâce à la planification GOAP avec recherche A*, et inclut un tableau de bord d'agents en direct sur /agents. Les deux sont présentées comme des démos hébergées sans installation, avec références aux répertoires source et aux ADR.

Documentation, vérification et licence

Le README renvoie à plusieurs documents pour différents publics : STATUS.md pour l'état actuel, USERGUIDE.md pour la référence quotidienne, un guide utilisateur Metaharness pour auditer les configurations d'agents, un gist de benchmark comparant à LangGraph, AutoGen et CrewAI, et verification.md pour prouver cryptographiquement que les octets installés correspondent à un témoin signé via ruflo verify. Il mentionne aussi une checklist de passerelle d'équipe pour les contrôles avant fusion. Le dépôt est sous licence MIT, copyright ruvnet 2024-2026. La licence accorde les droits d'utilisation, de copie, de modification, de fusion, de publication, de distribution, de sous-licence et de vente, et stipule que le logiciel est fourni 'en l'état', sans garantie. Elle ne dit rien sur les garanties de sécurité, le support ou la préparation à la production ; ce ne sont que des affirmations du README.

Vérifier ruflo dans son environnement

Exécutez les commandes d’installation de Ruflo et le scénario d’exemple du README, en contrôlant les fichiers de configuration et les sorties annoncées. Cette séquence porte sur ruflo et permet de confronter les fichiers, commandes et sorties réellement présents dans le dépôt aux attentes de votre cas d’usage. Le README ne permet pas de déduire les garanties qu’il ne formule pas.

Conclusion éditoriale

Pour ruflo, le choix convient aux équipes dont le besoin correspond aux fonctions décrites dans le README et qui peuvent contrôler leur environnement d’exécution. Il convient moins à celles qui attendent une garantie absente de la documentation. Commencez par Exécutez les commandes d’installation de Ruflo et le scénario d’exemple du README, en contrôlant les fichiers de configuration et les sorties annoncées.

Sources officielles

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Notes de la communauté

Notes de la communauté