ralph-orchestrator

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署 智能体 🍴 复刻 302 🐛 待处理 38 👀 关注 27
GitHub ↗
GitHub 星标 ★ 3194
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费，无在线服务

项目预览

ralph-orchestrator 项目界面预览图
图片来源：GitHub 官方仓库名片

项目数据

分类智能体
开发团队mikeyobrien
GitHubhttps://github.com/mikeyobrien/ralph-orchestrator
定价模式🏷️完全免费
价格说明开源免费，无在线服务
访问状态🔧 仅开源项目，无在线服务，需自行部署
是否开源是
开源协议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 星标★ 3194
上线时间2025-09-07 00:00:00
代码更新2026-11-06
仓库体积13.8 MB
本站数据更新2026-11-06
维护状态活跃
收录时间2026-09-22
浏览次数1

项目介绍

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

Star 增长趋势

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

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

使用教程

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

环境要求

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

安装与启动步骤

  1. 1用 npm 安装

    官方推荐方式，全局安装 ralph-cli 命令行工具，安装后可直接使用 ralph 命令。

    npm install -g @ralph-orchestrator/ralph-cli

  2. 2或用 Cargo 安装

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

    cargo install ralph-cli

  3. 3或用安装脚本

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

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

  4. 4初始化项目

    在项目目录中初始化 Ralph，并用 --backend 指定要驱动的 AI 编码助手后端。

    ralph init --backend claude

  5. 5规划功能

    启动交互式 PDD 会话做需求规划，会生成规格目录下的 requirements.md、design.md、implementation-plan.md。

    ralph plan "Add user authentication with JWT"

  6. 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

上一篇：tinyflow

下一篇：bot-crossing

同类项目推荐

job-description-skill 开源

粘贴JD，秒出匹配报告和面试预测，决定投不投。

Claude skill that reads a job description and hands back an HTML report — match sco···

★ 116 2026-08-09
LarkAgentX 开源

让 AI 直接住进飞书群聊，自动答疑干活

飞书逆向，飞书apis，飞书AI Agent

★ 292 2026-09-12
stimm 开源

用 WebRTC 编排超低延迟语音 AI 管道，快速搭建实时语音助手。

The Open Source Voice Agent Platform. Orchestrate ultra-low latency AI pipelines for···

★ 53 2026-08-09
golembot 开源

把 AI 编码代理接入你的聊天工具，一处配置，随处使用

Any Agent × Any Provider × Anywhere. Connect Cursor, Claude Code, OpenCode, or Cod···

★ 322 2026-08-09
ClawX 开源

不会命令行也能玩转 OpenClaw 智能体

ClawX is a desktop app that provides a graphical interface for OpenClaw AI agents. I···

★ 7600 2026-10-11
claude-command-center 开源

一个面板管住所有 AI 编码代理，并行开工效率翻倍

One local board for Claude Code, Codex, Cursor and 5 more coding agents. See which s···

★ 216 2026-08-09
mobileClaw 开源

让AI直接操控你的手机，自动完成各种应用操作

Open Android AI agent runtime for phone control, app automation, VLM screen reading,···

★ 379 2026-08-09
hermes-agent-idea-workflow 开源

把模糊想法一键变成 AI 可执行的开发规格

Pre-build idea-to-spec workflow skills for Hermes Agent: turn rough ideas into desig···

★ 275 2026-08-09
agentfield 开源

像管微服务一样管 AI 代理，一键部署自动扩容

Build, run and scale AI agents like API and microservices

★ 2645 2026-08-09