# Ruflo
An open-source AI agent orchestration platform, formerly "Claude Flow". Enables deploying multi-agent swarms, coordinating autonomous workflows, and building conversational AI systems. Created by ruvnet. 26.6k GitHub stars, MIT license, v3.5.48.
## Core Concept
Orchestrate 100+ specialized AI agents (coder, tester, reviewer, architect, security auditor, documenter, etc.) into coordinated swarms with various topologies (mesh, hierarchical, ring, star). Agents organized in queen-led hierarchies with weighted voting and Byzantine Fault Tolerance consensus.
## Key Features
- **Multi-agent swarms**: queen-led hierarchies (Strategic, Tactical, Adaptive), 8 worker types, BFT consensus, Raft protocol, Gossip/CRDT coordination
- **RuVector intelligence**: SONA (Self-Optimizing Neural Architecture) with <0.05ms adaptation, 9 RL algorithms, EWC++ to prevent catastrophic forgetting
- **Vector search**: HNSW at ~61us latency, 16,400 QPS, PostgreSQL-based with 77+ SQL functions
- **Cost optimization**: Agent Booster (WASM) for simple transforms (<1ms, zero tokens), Token Optimizer (30-50% reduction), intelligent model routing
- **Multi-provider**: Claude (Anthropic), GPT (OpenAI), Gemini (Google), Cohere, [[Ollama]] (local)
- **130+ built-in skills**, 27 hooks system, 12 background workers
- **[[Model Context Protocol (MCP)]] integration**
- IPFS-based decentralized plugin marketplace
## Architecture (4 Layers)
1. **Entry**: CLI, MCP Server, AIDefence security module
2. **Routing**: Q-Learning Router, Mixture of Experts (8 experts), skills engine, hooks
3. **Swarm Coordination**: queen hierarchies, worker pools, collective memory, drift prevention
4. **Resources**: AgentDB vector memory, background workers, session persistence, GitHub integration
## Tech Stack
- TypeScript / Node.js (primary)
- Rust + WebAssembly (performance-critical: policy engine, embeddings)
- PostgreSQL + RuVector extensions (vector storage)
- ONNX Runtime, MiniLM embeddings (local, no API calls)
## References
- Source code: https://github.com/ruvnet/ruflo
## Related
- [[Claude Code]]
- [[Ollama]]
- [[Model Context Protocol (MCP)]]
- [[Agentic Era]]
- [[Agentic Engineering]]
- [[Large Language Models (LLMs)]]