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 设计的「代理元框架」

Ruflo 是一个围绕大型语言模型（LLM）代理（尤其是通过 Claude Code 插件使用的 Anthropic 的 Claude）的框架，为其提供完整的执行环境。它集成了 CLI、一组「插件」、Web UI 和联邦层，使多个专业代理能够协作、记住过往工作，并安全地与其他机器上的代理通信。

开箱即用的功能

功能	对你的意义
100+ 预制代理	用于编码、测试、安全扫描、文档、架构、交易、物联网等的预构建代理
蜂群协调	代理被组织成分层或网状的「蜂群」，可达成共识并共享工作
自我学习循环	代理记录成功/失败；系统更新内部模型（SONA 神经模式、ReasoningBank）以改进未来行为
向量记忆（AgentDB）	持久化、HNSW 索引的嵌入，使代理可在会话间回忆事实（例如：「记住我最喜欢的颜色」）
联邦机制	零信任、认证通信，使不同机器或组织的代理可在不泄露数据的情况下协作
多提供方路由	支持 Claude、GPT、Gemini、Cohere、Ollama 以及任何 OpenAI 兼容端点；路由器为每个工具调用选择最佳模型
安全护栏	AIDefence、提示注入检测、CVE 扫描、路径遍历保护，以及「MetaHarness」审计（对整个代理设置进行评分）
插件市场	35+ 个插件（核心、记忆、智能、DevOps、领域专用）可单独或全部添加
Web UI（测试版）	一个托管聊天界面（`flo.ruv.io`），让你与任何模型对话，同时 Ruflo 运行与 CLI 相同的 MCP 工具。也支持通过 Docker 自托管
目标规划器 UI	一个 GOAP 风格的规划器（`goal.ruv.io`），将自然语言目标转化为 A* 搜索的代理计划，并可视化实时代理遥测数据

如何开始

轻量路径 – Claude Code 插件
```
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo ruflo-swarm@ruflo …
```
不在你的仓库中创建任何文件，仅添加斜杠命令和少量代理定义。
完整路径 – CLI 安装
```
npx ruflo@latest init   # 或交互式向导
```
生成 .claude/、.claude-flow/、CLAUDE.md 指南，并启动一个 MCP 服务器，供 CLI 和 UI 通信使用。
Web UI – 打开 https://flo.ruv.io/（无需 API 密钥）或运行 ruflo/src/ruvocal/ 中的 Dockerfile 自行托管。

典型工作流

用户 → Ruflo CLI（或 UI） → 路由器 → 蜂群 → 个别代理
          ↑                                 │
          └───── 记忆 ↔ 向量数据库 ↔ 知识图谱
          ↑                                 │
          └───── 学习循环（更新代理策略）

当你要求 Ruflo 「编写新功能并添加测试」 时，路由器会启动一个编码代理、一个测试生成代理和一个安全审计代理。这些代理并行运行，将结果存储在向量内存中，学习循环记录哪些方法有效，使下一次请求更快、更便宜。

适合谁使用

希望使用 LLM 辅助编码、自动化测试和持续安全检查，但不想编写自定义提示的开发团队
需要零信任联邦机制，以便不同部门或子公司安全共享 AI 工作的企业
探索多代理协调、GOAP 规划或通过 ruflo-ruvllm 插件实现本地 LLM 自我优化的研究人员 / 爱好者

获取更多信息

完整指南 – RuFlo Explained（14章 Markdown 逐步指南） – docs/ruflo-explained.md。
插件文档 – 每个插件位于 plugins/ 目录下，拥有独立的 README。
基准测试与审计 – 参见 docs/reviews/intelligence-system-audit-2026-05-29.md 和 scripts/ 中的基准测试脚本。
源代码 – 仓库包含 CLI（bin/）、MCP 服务器、Web UI（src/ruvocal/）和插件实现。

简而言之，Ruflo 是一个全面且可扩展的平台，将 LLM 转变为协作、记忆感知、自我优化的 AI 代理，同时提供命令行和基于 Web 的界面。