ruflo （多智能体协同与工作流框架）

ruvnet/ruflo

去点 Star

AI 应用与 AI Agent AI 模型与开发框架自动化与工作流

81,500

Stars

Forks

Watchers

Open Issues

未知

许可证

TypeScript

语言

创建时间

项目能做什么

Agent 控制底座，支持部署多智能体集群、协调自主工作流并构建对话式 AI 系统。

来源：基于仓库元数据 · 内容以仓库实际 README 为准

使用说明查看原始 README 原仓库文档

{
  "name": "ruflo",
  "description": "面向 Claude Code 和 Codex 的 Agent 原生框架（meta-harness），用于部署智能多 Agent 集群（swarms）、协调自主工作流、构建会话式 AI 系统，并集成自适应记忆、自学习与向量 RAG 能力。",
  "overview": "## 项目简介\n\nruflo 是专为 Claude Code 和 Codex 打造的 Agent 原生治理与编排框架（Agent meta-harness）。通过它可以轻松部署智能多 Agent 集群（swarms）、协调自主工作流并构建具备对话能力的 AI 系统。项目内置了自适应记忆（adaptive memory）、自学习智能（self-learning intelligence）、联邦协同（federation）以及向量 RAG 集成功能，并原生支持 Claude Code、Codex、Hermes 等工具。",
  "features": "## 核心功能\n\n- **智能多 Agent 集群部署**：协调与调度多 Agent 自主工作流（swarms）。\n- **原生集成支持**：针对 Claude Code、Codex 提供深度集成，并支持通过 MCP（Model Context Protocol）连接其他客户端。\n- **记忆与知识增强**：具备自适应记忆机制、向量 RAG 集成支持。\n- **自学习智能与联邦协同**：支持持续学习演进与 Federation 协同架构。\n- **可视化控制台与终端界面**：提供 Web 界面（ruflo console）以及独立的终端交互界面（TUI）。",
  "target_users": "## 适合谁用\n\n- 深度使用 Claude Code 或 Codex 进行辅助编程并希望引入多 Agent 协同的开发者。\n- 需要构建自主工作流、引入 Agent 自适应记忆及向量 RAG 检索的 AI 应用开发者。\n- 寻找开箱即用 Agent 集群管理及 MCP 服务支持的个人或团队开发者。",
  "installation": "## 安装步骤\n\n### 方式 1：一键初始化（推荐）\n在你的项目根目录下直接执行：\n```bash\nnpx ruflo@latest init\n```\n该命令会将 ruflo 的 Agent、hooks、记忆系统和 MCP server 注入到项目中。随后在同目录下启动 Claude Code 即可自动加载并分配任务：\n```text\nUse a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.\n```\n\n### 方式 2：仅作为 Claude Code 插件安装（无需在项目中增加文件）\n*要求 Claude Code 版本在 2.1.287 或更高版本。*\n在 Claude Code 内运行以下命令：\n```text\n/plugin marketplace add ruvnet/ruflo\n/plugin install ruflo-core@ruflo\n/plugin install ruflo-console@ruflo\n/plugin install ruflo-mods@ruflo\n/reload-plugins\n/ruflo\n```\n*注：若使用 Claude Code 2.1.292 或更高版本，也可在系统终端中执行：*\n```bash\nclaude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo\n```\n\n### 方式 3：交互式向导初始化\n```bash\nnpx ruflo@latest init wizard\n```\n\n### 方式 4：启动独立终端界面（TUI）\n无需 Claude Code 即可独立运行：\n```bash\nnpx ruflo tui\n```\n如需在脚本中输出单帧内容，可追加 `--plain` 参数。",
  "configuration": "## 配置说明\n\n### Codex 或其他 MCP 客户端配置\n对于不进行项目初始化的 MCP 客户端，请按以下参数进行配置：\n- **command（执行命令）**: `npx`\n- **arguments（运行参数）**: `[\"-y\", \"ruflo@latest\", \"mcp\", \"start\"]`\n\n### ruOS Desktop（可选）\n若通过 MCP 将 ruOS 连接至 ChatGPT 或 Claude，配置连接地址为：\n```text\nhttps://ruos.cognitum.one/mcp\n```\n\n*更多详细环境配置及高级参数原文未完整说明，请查看原仓库。*",
  "faq": "## 常见问题\n\n- **Q: 安装插件时提示权限问题该如何处理？**\n  A: README 中提醒，Mods（插件扩展）会以当前用户账户权限运行，在安装前请务必确认并审查对应代码安全性。\n- **Q: 其他详细配置和复杂任务使用方式？**\n  A: 此部分原文未详细说明，更多进阶用法请查看原仓库的 `docs/ruflo-explained.md` 及 `docs/USERGUIDE.md`。"
}

原始 README 摘录（英文原文，节选前 3000 字符）

<div align="center">

<a href="https://cognitum.one/agentic-engineering"><img src="ruflo/assets/ruflo-neon-flicker.gif" alt="Ruflo animated neon sign" width="100%"></a>

**An agent meta-harness for Claude Code and Codex.**

<!-- Try Ruflo — the 3 badges first-time visitors actually act on -->
[![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=npx%20ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Star on GitHub](https://img.shields.io/github/stars/ruvnet/ruflo?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/ruflo)
[![Follow @rUv on X](https://img.shields.io/badge/Follow-@rUv-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/rUv)

<p align="center">
<a href="docs/harness-origins.md"><img src="https://raw.githubusercontent.com/ruvnet/ruflo/e69e4b95aa08d65ea0f7715489bbf8e62a83a0d2/docs/assets/readme/badges/first-commit.svg" width="300" height="76" alt="Claude Flow lineage: first commit June 2, 2025 by rUv; inspect the evidence"></a>
<a href="data/npm-downloads.latest.json"><img src="https://raw.githubusercontent.com/ruvnet/ruflo/275aff65a198af758923669acff36f03d1f41623/docs/assets/readme/badges/downloads.svg" width="300" height="76" alt="Illustrative download counter starts at 98,000,000 and adds varied amounts each second in a 30 second loop. Verified dataset: 97,022,120 download events."></a>
<br>
<a href="https://github.com/ruvnet/claude-flow"><img src="https://raw.githubusercontent.com/ruvnet/ruflo/d1e80400bdefe01d3b13e70395f88fffab76bb18/docs/assets/readme/badges/claude.svg" width="300" height="76" alt="Claude Code plugin"></a>
<a href="https://www.npmjs.com/package/@claude-flow/codex"><img src="https://raw.githubusercontent.com/ruvnet/ruflo/d1e80400bdefe01d3b13e70395f88fffab76bb18/docs/assets/readme/badges/codex.svg" width="300" height="76" alt="Codex plugin"></a>
<a href="https://chatgpt.com/plugins/plugin_asdk_app_6ab674ff53c48191bb37040c343e31f3"><img src="docs/assets/readme/badges/chatgpt.svg" width="300" height="76" alt="ChatGPT plugin: RuFlo Federation"></a>
</p>

</div>

<a id="start-here"></a>

## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> Get started in one command

Run this in your project folder:

```bash
npx ruflo@latest init
```

Then open Claude Code in the same folder and give it a real task, for example:

```text
Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.
```

`init` adds ruflo's agents, hooks, memory and MCP server to the project, and Claude Code picks them up on its next start. Codex and other MCP clients work too: point them at `npx -y ruflo@latest mcp start`.

<p align="center"><img src="docs/assets/ruflo-console-tour.gif" width="720" alt="Looping recording of the ruflo console: overview, swarm view an

阅读完整原文

商业机会分析规则生成（AI 未配置）

综合评分 70.3 分。该项目在“个人可实施性”维度得 52 分，“付费可能性”维度得 72.0 分，差异化空间 70.0 分（评分依据见评分卡）。

将 ruflo 改造为垂直场景 SaaS

产品构想	保留核心能力，针对某一类用户（如某行业团队）做托管版，收取月费。
目标用户	有该需求的中小团队 / 独立站长
难度/周期	中 · 2~4 周（MVP）
收费模式	订阅制（如 ¥29~99/月）
竞争风险	需验证付费意愿；注意许可证合规
依据	数据支持的判断：许可证与关键词显示存在商用与付费场景

面向细分需求的二次开发产品

产品构想	基于 ruflo 的核心能力，聚焦一个更窄的场景（如某平台、某行业）做差异化。
目标用户	该细分场景用户
难度/周期	中 · 2~6 周
收费模式	买断制 / 订阅制 / 广告
竞争风险	细分需求规模需验证
依据	AI 推测：基于项目主题标签的判断

封装为在线小工具或 API 服务

产品构想	把项目最常用的一个功能做成网页小工具，靠流量变现或按量计费。
目标用户	搜索引擎带来的长尾用户
难度/周期	低 · 1~3 周
收费模式	免费引流 + 增值功能 / API 按量计费
竞争风险	同质化竞争，需做好 SEO
依据	AI 推测：基于技术栈与部署特征的判断

以上为规则引擎基于仓库公开数据生成的参考结论，包含推测成分，不构成投资或创业承诺；配置 AI 后可获得更深入的分析。

报告会保存到个人中心

竞品与相似项目 GitHub Search 真实检索

项目	中文简介	Stars	语言
affaan-m/ECC	为 Claude Code、Cursor 等 Agent 提供性能优化与记忆增强的运行框架	300,737	JavaScript
666ghj/MiroFish	简洁且通用的群体智能引擎，用于各类预测场景	85,206	Python
mem0ai/mem0	专为 AI Agent 和应用打造的生产级持久化记忆层基础设施	68,766	Python
vectorize-io/hindsight	具备自主学习能力的 AI Agent 记忆系统	60,287	Python
bojieli/ai-agent-book	《深入理解 AI Agent》开源主仓库，含全书正文、PDF 及配套代码	57,665	Python
zhayujie/CowAgent	支持多模型多渠道、具备记忆与任务规划能力的开源个人 AI 助手	47,870	Python

以上为通过 GitHub 官方 Search API 检索的相似项目，功能差异与优劣势需进一步人工确认，配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度	创建于，最近推送，发布过 100 个 Release
社区活跃	Star 81,500 / Fork 0 / Issue 0（数据支持，可自行核实）
许可证	未检测到（需人工确认）
主要风险	上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价

安装与使用

快速开始（以仓库 README 为准）

git clone https://github.com/ruvnet/ruflo.git
cd ruflo
# 请阅读仓库 README 获取确切安装步骤（依赖、配置、启动命令）

阅读原仓库文档

术语说明：Docker＝应用容器（把程序和依赖打包运行）；API Key＝调用外部服务的密钥；Git Clone＝把仓库代码下载到本地。常见错误：API Key 未配置 / 端口占用 / 数据库连接失败，多数项目在 README 的 Troubleshooting 章节有说明。

技术要求与部署

部署难度	中等
Docker	未提供（参考 README）
API Key	不需要（或可选）
独立数据库	不需要
GPU	不需要
本地运行	一般可行
预计成本	入门级云主机（1~2 核 1~2GB）或本地运行即可，无需昂贵服务器

由规则引擎基于 README 关键词推断，以仓库实际要求为准。

商业潜力评分 50 / 100

实际需求与应用场景 20% 80

市场付费可能性 20% 32

个人开发者可实施性 20% 57

产品差异化空间 15% 40

项目成熟度 10% 30

部署与运营成本 10% 60

社区活跃度 5% 40

展开评分依据

实际需求与应用场景（80 分）

· Star 数 81,500（对数刻度映射，Star≠付费意愿）

· 主题/描述命中需求关键词：ai, agent, workflow, rag

· 长期未更新（>100 天），需求信号减弱

市场付费可能性（32 分）

· 许可证信息缺失或不明，商用前需人工确认

· 与付费场景相关关键词：agent

个人开发者可实施性（57 分）

· 主要语言 TypeScript，生态成熟、个人可掌握

· 部署难度评估：中等

产品差异化空间（40 分）

· 项目已是头部，直接复制竞争激烈，需找细分场景

项目成熟度（30 分）

· 项目创建于 9999 天前，已度过早期不稳定期

部署与运营成本（60 分）

· 运行成本评估：入门级云主机（1~2 核 1~2GB）或本地运行即可，无需昂贵服务器

社区活跃度（40 分）

· Fork 0 / Issue 0，社区参与度可查

数据更新时间：2026-11-12 · 规则透明可复算，Star 数仅作为需求信号之一，不代表付费意愿。

Star 增长曲线（采集快照）

最近 30 次采集快照 · 2026-11-10 ~ 2026-11-12