ruvnet/ruflo

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

Ruflo – 為 Claude Code 與 Codex 所設計的「代理元框架」

Ruflo 是一個圍繞大型語言模型（LLM）代理（尤其是透過 Claude Code 插件使用的 Anthropic 的 Claude）的框架，為其提供完整的執行環境。它整合了 CLI、一組「插件」、Web UI 與聯邦層，使多個專業代理能協作、記住過往工作，並安全地與其他機器上的代理通訊。

開箱即用的功能

功能	對你的意義
100+ 預建代理	用於程式碼、測試、安全掃描、文件、架構、交易、物聯網等的預建代理
蜂群協調	代理被組織成階層式或網狀的「蜂群」，可達成共識並共享工作
自我學習循環	代理記錄成功／失敗；系統更新內部模型（SONA 神經模式、ReasoningBank）以改善未來行為
向量記憶（AgentDB）	持久化、HNSW 索引的嵌入，使代理可在會話間記憶事實（例如：「記住我最喜歡的顏色」）
聯邦機制	零信任、認證通訊，使不同機器或組織的代理可在不洩漏資料的情況下協作
多提供方路由	支援 Claude、GPT、Gemini、Cohere、Ollama 以及任何 OpenAI 相容端點；路由器為每個工具呼叫選擇最佳模型
安全護欄	AIDefence、提示注入偵測、CVE 掃描、路徑遍歷保護，以及「MetaHarness」審計（對整個代理設定進行評分）
插件市場	35+ 個插件（核心、記憶、智能、DevOps、領域專用）可單獨或全部新增
Web UI（測試版）	一個託管聊天介面（`flo.ruv.io`），讓你與任何模型對話，同時 Ruflo 執行與 CLI 相同的 MCP 工具。也支援透過 Docker 自行託管
目標規劃器 UI	一個 GOAP 風格的規劃器（`goal.ruv.io`），將自然語言目標轉換為 A* 搜尋的代理計畫，並可視化即時代理遙測資料

如何開始

輕量路徑 – Claude Code 插件
```
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo ruflo-swarm@ruflo …
```
不在你的程式庫中建立任何檔案，僅新增斜線指令與少量代理定義。
完整路徑 – CLI 安裝
```
npx ruflo@latest init   # 或互動式向導
```
產生 .claude/、.claude-flow/、CLAUDE.md 指南，並啟動一個 MCP 伺服器，供 CLI 與 UI 通訊使用。
Web UI – 開啟 https://flo.ruv.io/（無需 API 金鑰）或執行 ruflo/src/ruvocal/ 中的 Dockerfile 自行託管。

典型工作流程

使用者 → Ruflo CLI（或 UI） → 路由器 → 蜂群 → 個別代理
          ↑                                 │
          └───── 記憶 ↔ 向量資料庫 ↔ 知識圖譜
          ↑                                 │
          └───── 學習循環（更新代理策略）

當你要求 Ruflo 「撰寫新功能並新增測試」 時，路由器會啟動一個程式碼代理、一個測試產生代理與一個安全審計代理。這些代理並行執行，將結果儲存在向量記憶中，學習循環記錄哪些方法有效，使下一次請求更快、更便宜。

適合誰使用

希望使用 LLM 協助程式碼、自動測試與持續安全檢查，但不想撰寫自訂提示的開發團隊
需要零信任聯邦機制，以便不同部門或子公司安全共享 AI 工作的企業
探索多代理協調、GOAP 規劃或透過 ruflo-ruvllm 插件實現本地 LLM 自我優化的研究人員／愛好者

取得更多資訊

完整指南 – RuFlo Explained（14章 Markdown 逐步指南） – docs/ruflo-explained.md。
插件文件 – 每個插件位於 plugins/ 目錄下，擁有獨立的 README。
基準測試與審計 – 參見 docs/reviews/intelligence-system-audit-2026-05-29.md 與 scripts/ 中的基準測試腳本。
原始碼 – 倉儲包含 CLI（bin/）、MCP 伺服器、Web UI（src/ruvocal/）與插件實作。

簡而言之，Ruflo 是一個全面且可擴充的平台，將 LLM 轉化為協作、記憶感知、自我優化的 AI 代理，同時提供命令列與基於 Web 的介面。