What problem does it solve?
Builds and orchestrates iterative refinement loops for autonomous agents using Ralph — RalphRunner, enabling a defined 5-phase cycle (Run/Analyze/Learn/Plan/Halt) with support for scorers, reflectors, stop conditions, and streaming events, plus integration points for Swarm via RalphNode.
Core Features & Use Cases
- Orchestrates a 5-phase loop (Run, Analyze, Learn, Plan, Halt) using RalphRunner to manage execution, scoring, and feedback.
- Provides from_agent() factory to wire an Agent's run and run.stream() into a Ralph loop for seamless integration.
- Supports Swarm integration via RalphNode to embed refined loops into multi-agent workflows; streams RalphIterationEvent and RalphStopEvent for observability.
- Configurable stop conditions, scoring and reflection, enabling quality-gated iterative improvements across iterations.
Quick Start
Provide an Agent, create a RalphRunner via from_agent with scorers and a stop condition, then call run to commence iterative refinement.