====== 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:localai|LocalAI]]
  * [[ai:platformy:openwebui|OpenWebUI]]
  * [[https://github.com/ruvnet/ruflo|Ruflo na GitHubu]]