====== 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ář:** [[https://github.com/ruvnet/ruflo|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)

===== 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 ====

<code bash>
# 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
</code>

==== Základní použití ====

<code bash>
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ů
</code>

==== Integrace s Claude Code ====

<code bash>
claude mcp add ruflo -- npx ruflo@v3alpha mcp start
</code>

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

===== Viz také =====

  * [[ai:platformy:claude|Claude]]
  * [[ai:platformy:ui-a-self-hosted:localai|LocalAI]]
  * [[ai:platformy:ui-a-self-hosted:openwebui|OpenWebUI]]
  * [[https://github.com/ruvnet/ruflo|Ruflo na GitHubu]]

===== Typické workflow =====

[[https://claude-flow.ruv.io/|Ruflo]] dává v praxi největší smysl jako orchestrace nad [[ai:platformy:claude-code:start|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.

==== 1. Inicializace projektu ====

Podle [[https://github.com/ruvnet/ruflo|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.

<code bash>
# rychlý start bez globální instalace
npx ruflo@latest init

# interaktivní průvodce
npx ruflo@latest init --wizard
</code>

==== 2. Připojení přes MCP ====

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

<code bash>
claude mcp add ruflo -- npx -y ruflo@latest mcp start
claude mcp list
</code>

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.

==== 3. Běžný pracovní režim ====

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ů

==== 4. Kdy použít explicitní CLI ====

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:

<code bash>
npx ruflo@latest agent list
npx ruflo@latest agent spawn -t coder --name my-coder
npx ruflo@latest hive-mind spawn "Implement user authentication"
</code>

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

==== 5. Upgrade a údržba ====

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

<code bash>
npx ruflo@latest init upgrade
npx ruflo@latest init upgrade --add-missing
</code>

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í.

===== Limity a praktické poznámky =====

==== Šířka rozhraní ====

[[https://github.com/ruvnet/ruflo|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.

==== Největší smysl má v Claude Code ====

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ů.

==== Swarm není zadarmo ====

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.

==== Nároky na prostředí ====

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.

==== Přetrvávající staré názvosloví ====

[[https://github.com/ruvnet/ruflo/blob/main/CHANGELOG.md|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.

===== Zdroje =====

  * [[https://claude-flow.ruv.io/|Ruflo / Claude Flow – oficiální dokumentace]]
  * [[https://github.com/ruvnet/ruflo|Ruflo na GitHubu]]
  * [[https://github.com/ruvnet/ruflo/blob/main/CHANGELOG.md|Ruflo CHANGELOG]]