ralph-orchestrator

让 AI 编码代理自己循环干活，直到任务真正完成

ralph-orchestrator 是用 Rust 实现的一个自主 AI 智能体编排工具，它改进了经典的 Ralph Wiggum 技术——即让 AI 编码代理在循环中反复执行任务、根据反馈自我修正，直到达成目标。项目解决的核心问题是：单个 AI 代理（如 Claude Code、Codex CLI）在复杂多步任务中容易跑偏、中途放弃或缺乏持续迭代能力。它通过编排层管理任务循环、状态跟踪和代理调度，让代理能够自主地拆解目标、执行、验证并重试，从而完成更长的开发工作流。核心能力包括：多代理循环编排、与 Claude Code 和 Codex CLI 等命令行代理集成、任务状态持久化、以及可配置的迭代策略。适合希望让 AI 代理自主完成端到端开发任务的开发者，用 Rust 编写保证了性能和可靠性。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3152

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队mikeyobrien

所属国家

官网地址

GitHubhttps://github.com/mikeyobrien/ralph-orchestrator

定价模式free

价格说明开源免费，无在线服务

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型ai,ai-agents,ai-agents-framework,ai-developer-tools,claude-code,claude-code-cli,codex-cli,development-tools,development-workflow,gemini-cli,kiro,kiro-cli,opencode,ralph-loop,ralph-wiggum

GitHub 星标★ 3152

30天Star增速

HF 下载量

上线时间2025-09-07 00:00:00

最近更新2026-09-21 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-22

浏览次数0

使用教程

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

环境要求

Node.js >= 18 与 npm（网页仪表盘前端及 npm 安装方式需要）
Rust 1.75+（仅在使用 ralph-api 组件时需要）
已安装一个 AI 编码助手 CLI，如 Claude Code、Codex、Gemini CLI 等
可访问 GitHub Releases 或 npm registry（用于下载安装包）

安装与启动步骤

1用 npm 安装

官方推荐方式，全局安装 ralph-cli 命令行工具，安装后可直接使用 ralph 命令。
```
npm install -g @ralph-orchestrator/ralph-cli
```
2或用 Cargo 安装

Rust 开发者可选此方式，从 crates.io 编译安装 ralph-cli。
```
cargo install ralph-cli
```

3或用安装脚本

通过 GitHub Releases 提供的一键安装脚本下载并安装最新版。

curl --proto '=https' --tlsv1.2 -LsSf 
  https://github.com/mikeyobrien/ralph-orchestrator/releases/latest/download/ralph-cli-installer.sh | sh

4初始化项目

在项目目录中初始化 Ralph，并用 --backend 指定要驱动的 AI 编码助手后端。
```
ralph init --backend claude
```
5规划功能

启动交互式 PDD 会话做需求规划，会生成规格目录下的 requirements.md、design.md、implementation-plan.md。
```
ralph plan "Add user authentication with JWT"
```
6执行任务

按规划结果驱动代理循环执行，用 -p 指定任务提示；简单任务可跳过规划直接 run。
```
ralph run -p "Implement the feature in .ralph/specs/user-authentication/"
```

关键配置

配置项	必填	说明	示例
`--backend`	是	指定驱动哪个 AI 编码助手后端，如 claude。	`claude`
`-p`	是	传给代理的任务提示词或规格目录路径。	`Implement the feature in .ralph/specs/user-authentication/`
`.ralph/specs/`	否	规划阶段生成的规格文件目录，包含需求、设计与实施计划。	`.ralph/specs/user-authentication/`

如何确认成功

ralph run 会持续迭代，直到输出 LOOP_COMPLETE 或达到迭代上限，即表示本轮任务已结束。

常见问题

Q：三种安装方式该选哪个？

A：大多数用户推荐 npm 全局安装；Rust 开发者用 cargo install；想一键脚本安装则用 GitHub Releases 的 curl 安装脚本。

Q：Ralph 支持哪些后端？

A：支持 Claude Code、Kiro、Gemini CLI、Codex、Forge、Amp、Copilot CLI、OpenCode、Pi、Roo 和 OMP（oh-my-pi）。

Q：什么是 hat 系统？

A：Ralph 使用专门化的角色（hat）通过事件协同，角色包括 code-assist、debug、research、review 和 pdd-to-code-assist，用于结构化多步任务执行。

Q：可以用 Homebrew 安装吗？

A：目前该仓库的自动发布流程未发布 Homebrew 包，请优先使用 npm、Cargo 或 GitHub Releases 安装脚本。

注意事项

Ralph 循环会一直迭代直到输出 LOOP_COMPLETE 或达到迭代上限，注意观察是否触达上限。
使用前必须先准备好可用的 AI 编码助手 CLI，否则后端无法工作。
Homebrew 暂未通过官方自动发布流程提供，不要依赖该方式。

核心亮点

用 Rust 实现，性能好、二进制部署简单，适合长时间运行的编排循环
直接对接 Claude Code、Codex CLI 等主流命令行代理，落地门槛低
改进了原始 Ralph 技术，加入状态跟踪和循环控制，减少代理跑偏或提前放弃

不足之处

项目较新、星标三千出头，生态和文档成熟度仍在早期
强依赖外部 CLI 代理的可用性和稳定性，代理本身行为变化可能影响编排效果

适用场景

让 AI 代理自主完成一个多步骤的功能开发任务并反复验证
在无人值守场景下批量跑代码修复或重构循环
把 Claude Code/Codex CLI 接入自动化流水线做持续迭代

替代项目

AutoGPT、OpenHands、SWE-agent

项目介绍

ralph-orchestrator 是智能体领域的开源项目，由 mikeyobrien 开发，2025 年首次发布。

在全站 12,909 个收录项目中，它的 GitHub 星标数（3,152）位列前 30%，在智能体分类的 2,491 个项目里位列前 13%。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-21。开源免费，无在线服务。

它主要面向的使用场景是：让AI代理自主完成一个多步骤的功能开发任务并反复验证。同类可对比的替代方案包括 AutoGPT、OpenHands、SWE-agent。

上一篇：tinyflow

下一篇：bot-crossing