ruflo

像搭积木一样组建 AI 团队，复杂活交给它们自动跑。

开源 🏷️定价信息待确认 ✅ 目前可打开编程开发 🍴 复刻 9567 🐛 待处理 622 👀 关注 477

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 81323

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类编程开发

开发团队ruvnet

官网地址https://ruv.io

GitHubhttps://github.com/ruvnet/ruflo

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-memory,agent-orchestration,agentic-ai,agentic-workflow,ai-agents,autonomous-agents,claude,claude-code,codex,hnsw,mcp,mcp-server,multi-agent,multi-agent-systems,plugins,rvf,swarm,swarm-intelligence,typescript,vector-search

GitHub 星标★ 81323

上线时间2025-06-02 00:00:00

代码更新2026-11-09

仓库体积649.2 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

最早的 Agent 元框架，让开发者轻松部署多智能体集群、编排自主工作流并构建对话式 AI 系统。内置自适应记忆、自学习智能与 RAG 集成，原生支持 Claude Code、Codex 等主流工具，是搭建复杂 AI 应用的强大底座。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 81323

技术标签

agent-memory agent-orchestration agentic-ai agentic-workflow ai-agents

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

Node.js 与 npm 可用（需执行 npx / npm install -g）
类 Unix 环境需 POSIX shell：macOS / Linux / WSL / Git-Bash / MSYS
原生 Windows 可直接用 PowerShell 或 cmd
已安装 Claude Code 或 Codex 作为宿主工具（插件方式需在 Claude Code 内执行 /plugin 命令）

安装与启动步骤

1选择安装路径

README 提供两条差异很大的路径：Claude Code 插件方式（工作区零文件）与 CLI 方式 npx ruflo init（完整循环）。按需求二选一，生产用建议 CLI。
2一键安装(类 Unix)

在 macOS / Linux / WSL / Git-Bash 等 POSIX shell 中执行，从 jsDelivr 拉取安装脚本并运行。
```
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
```
3跨平台向导安装

交互式安装向导，在 PowerShell、cmd 等所有平台表现一致，Windows 用户推荐走这一条。
```
npx ruflo@latest init wizard
```
4全局安装 CLI

把 ruflo 装到全局，后续可直接使用 ruflo 命令，无需每次走 npx 拉取。
```
npm install -g ruflo@latest
```
5安装 Claude Code 插件

在 Claude Code 内按需安装核心与扩展插件，只增加斜杠命令和 agent 定义，不往工作区写文件。
```
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo
```

如何确认成功

走 CLI 路径后，检查工作区是否出现 .claude/、.claude-flow/、CLAUDE.md、helpers、settings 等文件；插件路径不写文件。

常见问题

Q：Windows 上提示 'bash' is not recognized 怎么办？

A：curl | bash 形式需要 POSIX shell（Git-Bash、WSL、MSYS）。改用 npx ruflo@latest init wizard，它原生支持 PowerShell 和 cmd，两者最终跑同一个 init 流程。

Q：插件方式和 CLI 方式有什么区别？

A：插件方式只提供斜杠命令、少量 skills 和 agent 定义，工作区零文件；CLI 方式提供 98 个 agents、60+ 命令、30 skills、MCP server、hooks 和 daemon，适合生产使用。

Q：插件会注册 MCP server 吗？

A：多数插件不自带 MCP server。ruflo-core 安装时会注册自己的 MCP server，工具名为 mcp__plugin_ruflo-core_ruflo__*，而非 CLI 脚手架里的裸名称。

Q：只想试一个插件，需要完整安装吗？

A：不需要。插件路径的定位就是“不承诺完整安装即可试用单个插件的命令”，适合轻量体验。

注意事项

两条安装路径的覆盖面差异很大，README 明确建议：生产使用选 CLI 路径（npx ruflo init）。
插件方式下工具名带前缀 mcp__plugin_ruflo-core_ruflo__，与 CLI 路径的 memory_store、swarm_init、agent_spawn 等裸名称不一致，写配置时别混用。
README 未给出 Node.js 最低版本、端口或环境变量要求，安装前请自行确认 npm 可用。