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 的代理元框架

是什麼 – Ruf Flo 是一個框架，位於基於大語言模型的編碼助手（Claude Code、Codex）周圍，將單一模型轉變為功能完整的自組織 AI 團隊。它提供 CLI、插件市場和 Web UI，支援 100+ 專業代理、持久向量記憶、群組協調、跨機器聯邦、安全防護等功能。

如何運作 – 核心循環如下：

使用者 → Ruflo CLI / MCP 伺服器 → 路由器 → 群組 → 代理 → 記憶 → LLM 提供者
                         ^                               |
                         +---- 學習循環 <------------+

該框架增加了工具、循環、沙箱和學習層，使代理能夠規劃、記憶、測試、改進和協作，而無需使用者管理這些細節。

主要功能（README 中列出）

功能	你將獲得
100+ 代理	用於編碼、測試、安全、文件、架構、交易、物聯網等的現成代理
群組協調	分層/網狀拓撲、共識機制、自適應路由
自我學習循環	代理記錄成功案例，更新行為（SONA 模式、ReasoningBank）
向量記憶（AgentDB）	HNSW 索引記憶，~0.99 recall@10，5-20k 條目時比暴力搜尋快 1.9-4.7 倍
聯邦	不同機器或組織間零信任、認證通訊
多提供者路由	Claude、GPT、Gemini、Cohere、Ollama、自訂 OpenAI 兼容端點
安全與合規	提示注入防護、PII 檢測、CVE 掃描、輸入驗證
元框架審計	評估代理設定（1-100 分）、快照設定、檢測回歸
Web UI（測試版）	多模型聊天、平行 MCP 工具呼叫、持久記憶、Docker 就緒的自托管部署
目標規劃器 UI	GOAP 風格的自然語言目標分解 → A* 規劃 → 實時代理執行
插件市場	33 個 Claude Code 插件 + 21 個 npm 插件，涵蓋核心、記憶、智能、DevOps、領域特定用例

安裝路徑

路徑	安裝內容	使用情境
Claude Code 插件（輕量版）	僅包含斜線命令和少量代理定義。不向倉儲添加任何檔案。	快速試用單個插件，無需承諾完整堆疊
完整 CLI 安裝（`npx ruflo init`）	所有 98 個代理、60+ 命令、MCP 伺服器、鉤子、守護程序、`.claude/` 與 `.claude‑flow/` 設定檔案
	需要完整編排層的生產環境

CLI 快速啟動（macOS/Linux/WSL/PowerShell）：

# 一行命令（POSIX shell）
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
# 或跨平台
npx ruflo@latest init wizard   # 互動式向導
# 非互動式
npx ruflo@latest init

你也可以透過 npm i -g ruflo 全域安裝。

MCP 伺服器註冊（用於 Claude Code）：

claude mcp add claude-flow -- npx ruflo@latest mcp start

生態系統與插件（精選類別）

核心與編排 – ruflo-core, ruflo-swarm, ruflo-autopilot, ruflo-federation。
記憶與知識 – ruflo-agentdb, ruflo-rag-memory, ruflo-ruvector（GPU 加速向量搜尋）、ruflo-knowledge-graph。
智能與學習 – ruflo-intelligence, ruflic‑graph-intelligence, ruflo-ruvllm（本地 LLM 路由）、ruflo-goals。
程式碼品質 – ruflo-testgen, ruflo-browser（Playwright）、ruflo-jujutsu（git-diff 風險評分）、ruflo-docs。
安全 – ruflo-security-audit, ruflo-aidefence。
方法論 – ruflo-adr, ruflo-ddd, ruflo-sparc, ruflo-metaharness, ruflo-arena。
DevOps – ruflo-migrations, ruflo-observability, ruflo-cost-tracker。
領域特定 – ruflo-iot-cognitum, ruflo-neural-trader, ruflo-market-data。

典型用例

AI 輔助軟體開發 – 寫程式碼，自動產生遺漏測試，執行瀏覽器整合測試，取得安全審計——全部由代理協調完成。
目標驅動自動化 – 聲明高階目標（如「發布一個新微服務」）；目標規劃器將其分解，分配任務給代理，並追蹤進度。
企業級代理聯邦 – 多個團隊運行 Ruflo 實例；代理在不洩漏資料的前提下安全交換工作。
自托管 AI 堆疊 – 在防火牆後執行 Web UI 和 ruvLLM 本地模型堆疊，實現完全離線開發。
金融科技或物聯網運營 – 使用領域特定插件（neural-trader, iot‑cognitum）建構自主交易機器人或車隊管理代理。

許可與社群

許可證：MIT（依徽章）。
星標 / 下載量：生態系統下載量 810 萬+，最近 14 天約 10.6 萬次 Git 克隆（如 README 所述）。
文件：14 章「Ruflo 解釋」指南、ADR、基準測試腳本、插件創建範本。

總結

Ruflo 是一個全棧、插件驅動的元框架，將 Claude Code / Codex 轉變為具備記憶、學習、安全和跨機器聯邦能力的協作式 AI 團隊。可透過托管 UI 即時試用，或透過單一 npx ruflo init 命令本地安裝，是面向代理式軟體工程及其他領域的實用、生產就緒平台。