ruvnet/ruflo

GitHub Trending (daily) 工具

摘要

Ruflo 是一个面向AI智能体的元工具集,提供诸如Claude Code插件和RuVector Agentic DB等工具与集成,作为开源项目在GitHub和npm上发布,在生态系统中拥有大量下载量。

🌊 原始的智能体元工具集。部署智能的多智能体集群,协调自主工作流,并构建对话式AI系统。具备自适应记忆、自学习智能、RAG集成,并原生集成Claude Code / Codex / Hermes 等众多组件
查看原文
查看缓存全文

缓存时间: 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-ruvectorruvector (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-cognitumIoT 设备管理——信任评分、异常检测、集群管理
ruflo-neural-traderneural-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

Product Hunt

HarnessRouter 提供单一 API 访问多个顶级 AI 代理,简化应用集成。

OpenForgeRL:在任何环境中训练基于框架的原生智能体

Hugging Face Daily Papers

OpenForgeRL 是一个开源框架,用于在各种环境中端到端训练基于框架的AI智能体。它通过轻量级代理和Kubernetes编排器,实现了在任何框架上大规模进行强化学习。该框架在智能体基准测试中取得了优异的结果,并表明强化学习能提高智能体的可靠性。

AI Agent – TRMNL

Hacker News Top

TRMNL 公测版推出 AI Agent,用户可通过自然语言提示创建插件,并支持使用 OpenRouter 或 Anthropic API 密钥。

@geekbb: 开源的 AI Agent 元编排框架,为 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 等多种 Agent 提供统一的编排层。用户可以在不同设备(终端、浏览器、手机、桌面应用)间无缝切换会话,让多…

X AI KOLs Timeline

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.