Toto je starší verze dokumentu!
Ruflo
Ruflo (dříve Claude Flow) je open-source enterprise platforma pro orchestraci AI agentů napsaná v TypeScriptu. Umožňuje koordinovat desítky specializovaných AI agentů v tzv. „hejnech„ (swarmech), která spolupracují na složitých vývojových úkolech — implementaci funkcí, code review, testování, bezpečnostních auditech nebo nasazení. Projekt byl původně vyvíjen pod názvem Claude Flow, po 5 800 commitech a 10 měsících vývoje byl přejmenován na Ruflo (Rust + flow states) a vydán ve verzi 3.5.
- Repozitář: github.com/ruvnet/ruflo
- npm balíček:
claude-flow(spouštěn jakoruflo) - Stabilní verze: 3.5.15
- Licence: MIT
- Autor: RuvNet (ruv@ruv.io)
Klíčové vlastnosti
- 60+ specializovaných AI agentů ve 8 kategoriích
- Nativní integrace s Claude Code přes MCP (Model Context Protocol)
- Self-learning architektura — systém si pamatuje úspěšné vzory a postupem času se zlepšuje
- Vektorová paměť s HNSW indexováním pro sub-milisekundové vyhledávání
- Podpora 6 různých LLM poskytovatelů s automatickým failoverem
- 5 konsensus protokolů pro fault-tolerant distribuované systémy (Byzantine PBFT, Raft, Gossip, CRDT, Quorum)
- 7 bezpečnostních vrstev vhodných pro produkční nasazení
- 215 MCP nástrojů a 26 CLI příkazů se 140+ subpříkazy
Technický stack
| Vrstva | Technologie |
|---|---|
| Jazyk | TypeScript 5.0+ (hlavní kód), Rust (WASM kernely) |
| Runtime | Node.js 20+ |
| Testování | Vitest |
| Databáze | SQLite (WAL persistence), PostgreSQL (RuVector) |
| Vektorové indexování | HNSW, IVF |
| Embeddingy | ONNX Runtime s MiniLM (lokálně), volitelně OpenAI |
| Protokol | MCP (Model Context Protocol) |
| WASM | Rust-kompilované kernely (Agent Booster) |
Instalace a spuštění
Předpoklady: Node.js 20+, npm 9+ (nebo pnpm / bun), nainstalovaný Claude Code.
Rychlá instalace
# One-line instalace curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/claude-flow@main/scripts/install.sh | bash # Nebo přes npx bez instalace npx ruflo@latest init --wizard
Základní použití
npx ruflo@latest init # inicializace projektu npx ruflo@latest mcp start # spuštění MCP serveru npx ruflo@latest --agent coder --task "..." # spuštění agenta s úkolem npx ruflo@latest --list # výpis dostupných agentů
Integrace s Claude Code
claude mcp add ruflo -- npx ruflo@v3alpha mcp start
Ruflo se po přidání jako MCP server zpřístupní přímo v Claude Code a je možné ho ovládat přirozeným jazykem v rámci konverzace s Claude.
Dále je podporována integrace s Claude Desktop (přes JSON konfiguraci mcpServers), VS Code, Cursor, Windsurf a JetBrains IDE.
Architektura agentů
Hive Mind
Jádro Rufla tvoří hierarchie Hive Mind:
- Queen agenti ve třech rolích: strategická, taktická, adaptivní
- Worker agenti v 8 specializacích: Researcher, Coder, Analyst, Tester, Architect, Reviewer, Optimizer, Documenter
Topologie hejn
Ruflo podporuje 4 základní + 2 pokročilé topologie:
- Hierarchical — klasická stromová struktura velení
- Mesh — každý agent komunikuje s každým
- Ring — agenti předávají informace v kruhu
- Star — centrální koordinátor + paprsky
- Hybrid a Adaptive — kombinace výše uvedených
Paměť a učení
- HNSW vektorová paměť — 150× až 12 500× rychlejší než lineární vyhledávání
- SONA (Self-Optimizing Neural Architecture) — adaptace pod 0,05 ms
- EWC++ (Elastic Weight Consolidation) — zabraňuje zapomínání naučených vzorů
- 3-scope izolace paměti — per-agent na úrovni project / local / user
- AgentDB v3 — 20+ kontrolerů pro hierarchickou, kauzální a explainabilní paměť
Optimalizace nákladů
Ruflo obsahuje inteligentní routing, který snižuje náklady na volání LLM:
- Agent Booster (WASM) — jednoduché kódové transformace bez LLM; 352× rychlejší, $0 náklady
- Chytrý routing — jednoduché úlohy → WASM, střední → Haiku/Sonnet, složité → Opus + Swarm
- Token Optimizer — 30–50% úspora tokenů kombinací technik (ReasoningBank, cache, batch)
- Prodloužení efektivního využití Claude Code až o 250 % přes inteligentní routing
Srovnání s alternativami
| Funkce | Ruflo v3 | CrewAI | LangGraph | AutoGen | Manus |
|---|---|---|---|---|---|
| SONA self-learning | ✓ | ✗ | ✗ | ✗ | ✗ |
| EWC++ prevence zapomínání | ✓ | ✗ | ✗ | ✗ | ✗ |
| HNSW vektorová paměť | ✓ | ✗ | ✗ | ✗ | ✗ |
| 5 konsensus protokolů | ✓ | ✗ | ✗ | ✗ | ✗ |
| Nativní MCP integrace | ✓ | ✗ | ✗ | ✗ | ✗ |
| Fault-tolerant distribuovanost | ✓ | částeč. | částeč. | ✗ | ✗ |
Bezpečnost
Ruflo nasazuje 7 bezpečnostních vrstev:
- Input validation
- Path traversal prevention
- Command sandboxing
- Prototype pollution protection
- TOCTOU protection
- Information disclosure prevention
- CVE monitoring
Pluginy
Ruflo má plugin systém s IPFS marketplace a 14+ hotovými pluginy, včetně specializovaných pro compliance prostředí:
- Healthcare (HIPAA)
- Financial (PCI-DSS)
- Legal
- Quantum-inspired computing