Ruflo – platforma pro orchestraci AI agentů

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 jako ruflo)
• Stabilní verze: 3.5.15
• Licence: MIT
• Autor: RuvNet (ruv@ruv.io)

• 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

Předpoklady: Node.js 20+, npm 9+ (nebo pnpm / bun), nainstalovaný Claude Code.

# 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

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ů

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.

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

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

• 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ěť

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

Ruflo nasazuje 7 bezpečnostních vrstev:

1. Input validation
2. Path traversal prevention
3. Command sandboxing
4. Prototype pollution protection
5. TOCTOU protection
6. Information disclosure prevention
7. CVE monitoring

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

• Claude
• LocalAI
• OpenWebUI
• Ruflo na GitHubu

Ruflo dává v praxi největší smysl jako orchestrace nad Claude Code. Typický workflow není o ručním volání každého interního nástroje, ale o tom, že se nejdřív připraví projekt, připojí MCP server a teprve potom se řeší explicitní swarm nebo agent příkazy tam, kde je potřeba větší kontrola.

Podle README projektu se projekt obvykle inicializuje přes npx nebo instalační skript. Tím se připraví lokální kontext, helpery a soubory, ze kterých pak Ruflo vychází při routování práce.

# rychlý start bez globální instalace
npx ruflo@latest init
 
# interaktivní průvodce
npx ruflo@latest init --wizard

Pro běžnou práci s Claude Code je praktické přidat Ruflo jako MCP server a ověřit, že je skutečně zaregistrovaný:

claude mcp add ruflo -- npx -y ruflo@latest mcp start
claude mcp list

V této chvíli se Ruflo chová jako orchestrace nad běžnou konverzací. V README je výslovně popsané, že po init není nutné učit se všechny dostupné nástroje ručně — hooks a routing mají část práce převzít automaticky.

Prakticky to znamená tento sled:

• zadáš úkol v Claude Code běžným jazykem
• Ruflo podle složitosti rozhodne, jestli stačí jednoduchý transform, jeden agent nebo koordinovaná skupina
• při opakovaných typech úloh využije uložené vzory a paměť
• explicitní swarm orchestrace má smysl hlavně u větších změn, review nebo auditů

Když je potřeba mít větší kontrolu nad rolí agentů nebo nad stylem koordinace, dává smysl sáhnout po explicitních CLI příkazech z dokumentace:

npx ruflo@latest agent list
npx ruflo@latest agent spawn -t coder --name my-coder
npx ruflo@latest hive-mind spawn "Implement user authentication"

Tohle je vhodnější pro delší nebo rozdělené úlohy než pro drobné jednorázové úpravy.

Dokumentace počítá i s průběžným doplňováním nových helperů, skills a agentů:

npx ruflo@latest init upgrade
npx ruflo@latest init upgrade --add-missing

Přepínač –add-missing je praktický ve chvíli, kdy chceš doplnit nové skills, agenty nebo pomocné soubory bez přepsání stávajících customizací.

Ruflo README samo upozorňuje, že není nutné učit se všechny MCP nástroje a CLI příkazy ručně. To je užitečný signál: projekt má velkou plochu rozhraní a při příliš brzkém použití všech možností se z něj snadno stane další vrstva komplexity nad už tak složitým AI workflow.

Ruflo umí fungovat i přes další klienty a MCP prostředí, ale dokumentace je nejsilnější právě kolem Claude Code. Prakticky to znamená, že mimo Claude Code se častěji řeší ruční konfigurace MCP serveru, rozdíly mezi klienty a menší množství přímočarých návodů.

V dokumentaci je přímo doporučené držet se u kódovacích úloh spíš hierarchické topologie a menšího počtu agentů. Je to dobrá připomínka, že více agentů automaticky neznamená lepší výsledek. S rostoucím počtem workerů roste i koordinační režie, riziko driftu a potřeba průběžné kontroly.

Podle instalační části README je potřeba minimálně Node.js 20+ a odpovídající package manager. Dokumentace zároveň rozlišuje lehčí instalaci –omit=optional a plnou defaultní instalaci s volitelnými ML a embedding závislostmi. Praktický limit je tedy jednoduchý: pokud chceš jen vyzkoušet CLI a MCP integraci, je lepší začít menším profilem; plná instalace přidává další závislosti a provozní složitost.

Changelog projektu potvrzuje rebranding Claude Flow → Ruflo, ale v ekosystému pořád zůstává staré pojmenování na více místech — například v URL dokumentace, v npm balíčku claude-flow nebo ve starších referencích. Při hledání návodů a issue je proto potřeba počítat s oběma názvy.

• Ruflo / Claude Flow – oficiální dokumentace
• Ruflo na GitHubu
• Ruflo CHANGELOG