ruvnet/ruflo
摘要
Ruflo 是一个面向AI智能体的元工具集,提供诸如Claude Code插件和RuVector Agentic DB等工具与集成,作为开源项目在GitHub和npm上发布,在生态系统中拥有大量下载量。
查看缓存全文
缓存时间: 2026/08/21 21:55
ruvnet/ruflo 源码:https://github.com/ruvnet/ruflo
Ruflo 横幅 (https://cognitum.one/agentic-engineering)
试用 UI 测试版 — flo.ruv.io (https://flo.ruv.io/)
npm 版本 (ruflo) (https://www.npmjs.com/package/ruflo)
MIT 许可证 (https://opensource.org/licenses/MIT)
在 GitHub 上点星 (https://github.com/ruvnet/claude-flow)
目标规划器 (https://goal.ruv.io/)
实时代理 (https://goal.ruv.io/agents)
🕸️ RuVector 代理数据库 (https://github.com/ruvnet/ruvector)
生态系统下载量 (https://github.com/ruvnet/ruflo/blob/main/data/clone-data.proof.json)
Git 克隆量 (14天) (https://github.com/ruvnet/ruflo/blob/main/data/clone-data.ledger.json)
Claude Code (https://github.com/ruvnet/claude-flow)
Codex 插件 (https://www.npmjs.com/package/@claude-flow/codex)
Ruflo
一个为 Claude Code 和 Codex 设计的代理元工具。
代理 = 模型 + 工具。 模型负责生成,而工具为其提供工具、记忆、循环、沙箱和控制,使其能够真正工作。
Ruflo 就是这个工具 —— 这是围绕 Claude Code 和 Codex 的执行层,它添加了 100 多个专用代理、协调的集群、自学习记忆、跨机器的联邦通信以及企业级安全护栏。
因此,代理不仅能运行,还能协作。
只需一个 npx ruflo init 就能赋予 Claude Code 一个神经系统:代理自组织成集群,从每次任务中学习,跨会话记忆,并且——通过联邦机制——可以安全地与其他机器上的代理通信而不泄露数据。
你继续编写代码。Ruflo 处理协调工作。
自学习/自优化代理架构
用户 --> Ruflo (CLI/MCP) --> 路由器 --> 集群 --> 代理 --> 记忆 --> LLM 提供商
^ |
+---- 学习循环 <-------+
Ruflo 新手?
你不需要学习 314 个 MCP 工具或 26 个 CLI 命令。执行init后,只需正常使用 Claude Code——钩子系统会自动路由任务,从成功模式中学习,并在后台协调代理。
📖 背景 —— 名称的由来
Claude Flow 现更名为 Ruflo——由
rUv(https://ruv.io) 命名,他热爱 Rust、心流状态以及构建感觉必然的东西。“Ru” 代表 rUv。“flo” 代表工作到凌晨三点。底层由Cognitum.One(https://cognitum.one/?RuFlo) 代理架构驱动,运行着一个基于 Rust 的增强 AI 引擎、嵌入、记忆和插件系统。
Ruflo 插件
快速开始
有两种不同的安装路径,功能范围大相径庭。根据你的需求选择(#1744):
| Claude Code 插件 | CLI 安装 (npx ruflo init) | |
|---|---|---|
| 提供内容 | 斜杠命令 + 少量技能 + 每个插件的代理定义 | 完整的 Ruflo 循环——98 个代理、60 多个命令、30 项技能、MCP 服务器、钩子、守护进程 |
| 工作区中的文件 | 零 | .claude/、.claude-flow/、CLAUDE.md、辅助工具、设置文件 |
| 是否注册 MCP 服务器 | 仅当安装了 ruflo-core 时(它自带 .mcp.json)——大多数其他插件不注册 | 是 |
| 是否安装钩子 | 否 | 是 |
| 最适合 | 尝试单个插件的命令,无需承诺完整安装 | 生产环境使用——所有功能均按文档工作 |
路径 A — Claude Code 插件(轻量级,仅斜杠命令)
# 添加市场
/plugin marketplace add ruvnet/ruflo
# 安装核心 + 任何你需要的插件
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo
这会添加斜杠命令和代理定义。上面安装的 ruflo-core 会在安装时注册自己的 MCP 服务器——其工具可作为 mcp__plugin_ruflo-core_ruflo__*(例如 mcp__plugin_ruflo-core_ruflo__memory_store)调用,而不是 CLI 路径脚手架使用的裸 memory_store/swarm_init/agent_spawn 名称。其他插件通常不自带自己的 MCP 服务器。如需使用 CLI 路径工具名称的完整循环,请使用下面的路径 B。
🔌 全部 35 个插件
核心与编排
| 插件 | 功能 |
|---|---|
| ruflo-core | 基础——服务器、健康检查、插件发现 |
| ruflo-swarm | 将多个代理协调为一个团队 |
| ruflo-autopilot | 让代理在循环中自主运行 |
| ruflo-loop-workers | 按计划调度后台任务 |
| ruflo-workflows | 可复用的多步骤任务模板 |
| ruflo-federation | 不同机器上的代理安全协作 |
记忆与知识
| 插件 | 功能 |
|---|---|
| ruflo-agentdb | 用于代理记忆的快速向量数据库 |
| ruflo-rag-memory | 智能检索——混合搜索、图跳转、多样性排序 |
| ruflo-rvf | 跨会话保存和恢复代理记忆 |
| ruflo-ruvector | ruvector (https://npmjs.com/package/ruvector) —— GPU 加速搜索、图 RAG、103 个工具 |
| ruflo-knowledge-graph | 构建和遍历实体关系图 |
智能与学习
| 插件 | 功能 |
|---|---|
| ruflo-intelligence | 代理从过去的成功中学习并变得更聪明 |
| ruflo-graph-intelligence | 亚线性图推理——PageRank、增量更新、复杂性感知执行(ADR-123) |
| ruflo-daa | 动态代理行为和认知模式 |
| ruflo-ruvllm | 运行本地 LLM(Ollama 等),带有智能路由 |
| ruflo-goals | 将大目标分解为计划并跟踪进度 |
代码质量与测试
| 插件 | 功能 |
|---|---|
| ruflo-testgen | 查找缺失的测试并自动生成 |
| ruflo-browser | 使用 Playwright 自动化浏览器测试 |
| ruflo-jujutsu | 分析 git diff,评估风险,建议审查者 |
| ruflo-docs | 自动生成和维护文档 |
安全与合规
| 插件 | 功能 |
|---|---|
| ruflo-security-audit | 扫描漏洞和 CVE |
| ruflo-aidefence | 阻止提示注入,检测个人身份信息,安全扫描 |
架构与方法论
| 插件 | 功能 |
|---|---|
| ruflo-adr | 跟踪架构决策记录 |
| ruflo-ddd | 领域驱动设计脚手架——上下文、聚合、事件 |
| ruflo-sparc | 引导式五阶段开发方法论,带有质量门 |
| ruflo-metaharness | 评估你的代理设置,扫描工具配置的安全风险,并跟踪随时间的变化(指南) |
| ruflo-arena | 竞争性规则学——在锦标赛中让代理策略相互对抗,通过爬山法和协同进化优胜者(ADR-147/148) |
DevOps 与可观测性
| 插件 | 功能 |
|---|---|
| ruflo-migrations | 安全管理数据库架构变更 |
| ruflo-observability | 结构化日志、跟踪和指标集中管理 |
| ruflo-cost-tracker | 跟踪令牌使用量,设置预算,获取成本警报 |
可扩展性
| 插件 | 功能 |
|---|---|
| ruflo-agent | 运行代理——本地 WASM 沙箱 (rvagent) + Anthropic Claude 托管代理(云) |
| ruflo-plugin-creator | 脚手架、验证和发布你自己的插件 |
领域特定
| 插件 | 功能 |
|---|---|
| ruflo-iot-cognitum | IoT 设备管理——信任评分、异常检测、集群管理 |
| ruflo-neural-trader | neural-trader (https://npmjs.com/package/neural-trader) —— AI 交易,包含 4 个代理、回测、112+ 工具 |
| ruflo-market-data | 吸收市场数据,向量化 OHLCV,检测模式 |
CLI 安装
macOS / Linux / WSL / Git-Bash:
# 一行安装(仅限 POSIX shell——请参阅下方的 Windows 说明)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
所有平台(包括原生 Windows PowerShell / cmd):
# 交互式设置向导——在每个平台上运行方式相同
npx ruflo@latest init wizard
# 快速非交互式初始化
# npx ruflo@latest init
# 或全局安装
npm install -g ruflo@latest
💡 Windows 用户:
curl ... | bash形式需要 POSIX shell(Git-Bash、WSL、MSYS)。npx ruflo@latest init wizard命令可在 PowerShell 和 cmd 中原生运行。如果遇到'bash' is not recognized错误,请改用npx命令——两者最终执行相同的初始化流程。
MCP 服务器
# 在 Claude Code 中将 Ruflo 添加为 MCP 服务器
claude mcp add claude-flow -- npx ruflo@latest mcp start
你将获得的功能
| 功能 | 描述 |
|---|---|
| 🤖 100 多个代理 | 用于编码、测试、安全、文档、架构的专用代理 |
| 📡 通信层 | 零信任联邦——跨机器/组织的代理安全地发现、认证和交换工作 |
| 🐝 集群协调 | 层级、网格和自适应拓扑,带有共识机制 |
| 🧠 自学习 | SONA 神经模式、推理库、轨迹学习 |
| 💾 向量记忆 | HNSW 索引的 AgentDB——测量显示在 N=20k 时快约 1.9 倍,在 N=5k 时快约 3.2–4.7 倍(与暴力搜索相比,recall@10 约 0.99);ANN 在交叉点以上胜出,在小 N 时持平或略逊。参见 审计报告 + scripts/benchmark-intelligence.mjs |
| ⚡ 后台工作者 | 12 个自动触发的工作者(审计、优化、测试缺口等) |
| 🧩 插件市场 | 33 个原生 Claude Code 插件 + 21 个 npm 插件 |
| 🔌 多提供商 | Claude、GPT、Gemini、Cohere、Ollama,带有智能路由 |
| 🛡️ 安全 | AIDefence、输入验证、CVE 修复、路径遍历防护 |
| 🌐 代理联邦 | 具有零信任安全性的跨安装代理协作 |
| 🔬 元工具 | 在发布前审计你的 AI 代理设置。评估就绪度(1-100),扫描工具配置的安全问题,对整个项目进行快照以跟踪回归,并查找与你的仓库匹配的模板。ruflo eject 可将 ruflo 项目转换为独立的代理工具包并拥有自己的名称。完整指南。 |
| 💬 Web UI 测试版 (https://flo.ruv.io/) | 在 flo.ruv.io 上进行多模型聊天,支持并行 MCP 工具调用和浏览器内 WASM 工具库 |
| 🎯 RuFlo 研究 (https://goal.ruv.io/) | 在 goal.ruv.io 上的 GOAP A* 规划器——自然语言目标 → 可执行代理计划,/agents (https://goal.ruv.io/agents) 处提供实时代理仪表板 |
Web UI(测试版)——可自托管,托管演示位于 flo.ruv.io (https://flo.ruv.io/)
RuFlo 的 Web UI 是一个内置模型上下文协议(MCP)工具调用的多模型 AI 聊天。 你可以与 Qwen、Claude、Gemini 或 OpenAI 对话,同时 RuFlo 调用与 CLI 相同的 MCP 工具——代理编排、持久记忆、集群协调、代码审查、GitHub 操作——直接从聊天中调用。无需安装,无需 API 密钥即可尝试。
| 它是什么 | 为什么重要 | |
|---|---|---|
| 🧠 | 任意模型,本地或远程 | 开箱即用 6 个精选前沿模型——Qwen 3.6 Max(默认)、Claude Sonnet 4.6、Claude Haiku 4.5、Gemini 2.5 Pro、Gemini 2.5 Flash、OpenAI——通过 OpenRouter。添加你自己的:任何 OpenAI 兼容端点(vLLM、Ollama、LM Studio、Together、Groq、自托管)。 |
| 🦾 | ruvLLM 自学习 AI | 原生支持 ruvLLM (https://github.com/ruvnet/RuVector/tree/main/examples/ruvLLM)(位于 ruvnet/RuVector/examples/ruvLLM)——RuFlo 的自我改进本地模型层。路由到 MicroLoRA 适配器,通过 SONA 从你的轨迹中学习,并保留在你的机器上。可与云模型配对使用或完全离线运行。 |
| 🛠️ | 约 210 个工具,随时可调用 | 5 个服务器组(核心、智能、代理、记忆、开发工具)加上一个 18 个工具的库,完全在浏览器中运行——可离线工作。 |
| 🔌 | 自带 MCP 服务器 | 点击聊天输入框中的 MCP (n) 标签 → 添加服务器 并粘贴任何 MCP 端点(HTTP、SSE 或 stdio)。你的工具会加入 RuFlo 原生工具的同一并行执行流程。在 localhost:3000 上运行本地 MCP 服务器,它就能正常工作。 |
| ⚡ | 工具并行运行 | 一次模型响应可以同时触发 4-6 个以上的工具。UI 将它们显示为卡片,并带有 步骤 1 — 2 个工具已完成 的徽章,以便你确切知道运行了什么。 |
| 💾 | 持久的记忆 | 说 “记住我最喜欢的颜色是靛蓝色”,几周后再次询问——RuFlo 会记得。由 AgentDB + HNSW 向量搜索支持(测量显示在交叉点以上比暴力搜索快约 1.9–4.7 倍,recall@10 约 0.99)。 |
| 📘 | 内置功能导览 | 点击侧边栏中的问号图标——会打开一个“RuFlo 功能”模态框,包含完整工具列表、模型优势、架构和键盘快捷键。 |
| 🏠 | 可自托管 | Web UI 以 Docker 镜像(ruflo/src/ruvocal/Dockerfile)形式发布,内嵌 Mongo。部署到你自己的 Cloud Run / Fly / Kubernetes / docker-compose。托管的 flo.ruv.io (https://flo.ruv.io/) 演示是一个选项;运行自己的实例完全受支持。 |
| 🚀 | 零安装尝试 | 打开托管 URL,选择一个模型,输入问题。这就是整个入门流程。 |
试用托管演示: https://flo.ruv.io/ —— 无需账户,无需 API 密钥。
运行你自己的实例: 源代码位于 ruflo/src/ruvocal/,包含一个多阶段 Dockerfile(INCLUDE_DB=true 会构建 MongoDB)和一个用于 Google Cloud Run 的 cloudbuild.yaml。架构参见 ADR-033,路线图参见 issue #1689 (https://github.com/ruvnet/ruflo/issues/1689)。
目标规划器 UI —— 自主代理位于 goal.ruv.io (https://goal.ruv.io/)
将高层目标转化为可执行的代理计划。
goal.ruv.io 是 RuFlo 托管的目标导向行动规划(GOAP)前端——用自然语言描述一个结果,观察 RuFlo 将其分解为前提、行动和状态空间中的 A* 路径,然后将工作分派给 /agents (https://goal.ruv.io/agents) 处的实时代理。
| 它是什么 | 为什么重要 | |
|---|---|---|
| 🎯 | 自然语言目标 | 输入 “完成带有测试和 PR 的认证重构” —— RuFlo 提取成功标准、约束条件和隐含的前提。无需 JSON,无需领域特定语言。 |
| 🧭 | GOAP A 规划器* | 将经典游戏 AI 规划移植到软件工作中:通过具有前提/效果的动作进行状态空间搜索,以找到最短可行路径。当状态改变时动态重新规划。 |
| 🤖 | 实时代理仪表板 | goal.ruv.io/agents (https://goal.ruv.io/agents) 显示每个已生成的代理——角色、当前步骤、记忆命名空间、令牌预算、状态。点击可检查轨迹、终止失控的工作者或重新分配任务。 |
| 🌳 | 可视化计划树 | 目标渲染为可折叠的操作树,带有优先级和依赖关系。点击分支可深入查看前置条件、预期输出和实时进度更新。 |
相似文章
HarnessRouter
HarnessRouter 提供单一 API 访问多个顶级 AI 代理,简化应用集成。
OpenForgeRL:在任何环境中训练基于框架的原生智能体
OpenForgeRL 是一个开源框架,用于在各种环境中端到端训练基于框架的AI智能体。它通过轻量级代理和Kubernetes编排器,实现了在任何框架上大规模进行强化学习。该框架在智能体基准测试中取得了优异的结果,并表明强化学习能提高智能体的可靠性。
AI Agent – TRMNL
TRMNL 公测版推出 AI Agent,用户可通过自然语言提示创建插件,并支持使用 OpenRouter 或 Anthropic API 密钥。
@Radha_AI:安装这个之后,Claude Code 的体验完全不同。Anthropic 悄悄发布了一个名为 clau… 的官方插件
Anthropic 悄然推出了一款名为 claude-code-setup 的官方插件,它能扫描项目并推荐 hooks、skills、MCP 服务器、子代理和自动化功能,从而将 Claude Code 从“还不错”转变为完整的 AI 开发环境。
@geekbb: 开源的 AI Agent 元编排框架,为 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 等多种 Agent 提供统一的编排层。用户可以在不同设备(终端、浏览器、手机、桌面应用)间无缝切换会话,让多…
Omnigent is an open-source meta-orchestration framework that provides a unified orchestration layer over multiple AI agents like Claude Code, Codex, and Cursor. It enables seamless cross-device session switching, multi-agent collaboration, policy enforcement, and cloud sandbox execution.