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 命令本地安装，是面向代理式软件工程及其他领域的实用、生产就绪平台。