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.
claude-flow (spouštěn jako ruflo)| 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) |
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:
Ruflo podporuje 4 základní + 2 pokročilé topologie:
Ruflo obsahuje inteligentní routing, který snižuje náklady na volání LLM:
| 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č. | ✗ | ✗ |
Ruflo nasazuje 7 bezpečnostních vrstev:
Ruflo má plugin systém s IPFS marketplace a 14+ hotovými pluginy, včetně specializovaných pro compliance prostředí:
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:
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.