内容摘录
<!-- 2026-01-28 -->
Ralph Orchestrator
License
Rust
Build
Coverage
Mentioned in Awesome Claude Code
Docs
A hat-based orchestration framework that keeps AI agents in a loop until the task is done.
"Me fail English? That's unpossible!" - Ralph Wiggum
**Documentation** | **Getting Started** | **Presets**
Installation
Via npm (Recommended)
Via Homebrew (macOS/Linux)
Via Cargo
Quick Start
Ralph iterates until it outputs LOOP_COMPLETE or hits the iteration limit.
For simpler tasks, skip planning and run directly:
Web Dashboard (Alpha)
**Alpha:** The web dashboard is under active development. Expect rough edges and breaking changes.
<img width="1513" height="1128" alt="image" src="https://github.com/user-attachments/assets/ce5f072f-3d81-44d8-8f2f-88b42b33a3be" />
Ralph includes a web dashboard for monitoring and managing orchestration loops.
**Requirements:**
Rust toolchain (for ralph-api)
Node.js >= 18 + npm (for the frontend)
On first run, ralph web auto-detects missing node_modules and runs npm install.
To set up Node.js:
For development:
What is Ralph?
Ralph implements the Ralph Wiggum technique — autonomous task completion through continuous iteration. It supports:
**Multi-Backend Support** — Claude Code, Kiro, Gemini CLI, Codex, Amp, Copilot CLI, OpenCode
**Hat System** — Specialized personas coordinating through events
**Backpressure** — Gates that reject incomplete work (tests, lint, typecheck)
**Memories & Tasks** — Persistent learning and runtime work tracking
**31 Presets** — TDD, spec-driven, debugging, and more
RObot (Human-in-the-Loop)
Ralph supports human interaction during orchestration via Telegram. Agents can ask questions and block until answered; humans can send proactive guidance at any time.
Quick onboarding (Telegram):
**Agent questions** — Agents emit human.interact events; the loop blocks until a response arrives or times out
**Proactive guidance** — Send messages anytime to steer the agent mid-loop
**Parallel loop routing** — Messages route via reply-to, @loop-id prefix, or default to primary
**Telegram commands** — /status, /tasks, /restart for real-time loop visibility
See the Telegram guide for setup instructions.
Documentation
Full documentation is available at **mikeyobrien.github.io/ralph-orchestrator**:
Installation
Quick Start
Configuration
CLI Reference
Presets
Concepts: Hats & Events
Architecture
Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines and CODE_OF_CONDUCT.md for community standards.
License
MIT License — See LICENSE for details.
Acknowledgments
**Geoffrey Huntley** — Creator of the Ralph Wiggum technique
**Strands Agents SOP** — Agent SOP framework
**ratatui** — Terminal UI framework
---
*"I'm learnding!" - Ralph Wiggum*