Ralph
Ralph is an autonomous AI agent loop that runs AI coding tools (Amp, Claude Code, Antigravity, etc.) repeatedly until all PRD items are complete.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
55/100 Fair
- Maintained
- 44last commit 292 days ago
- Popular
- 8722,247 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 1016 GB minimum RAM
- Security check
- 90no serious findings, CI
Availability: platform listings confirmed today, links checked 18 days ago
- GitHub stars
- 22,247
- Open issues
- 75
- Last commit
- 2026-02-02
- License
- MIT
- Activity
- stale
Checked 6 days ago - source: GitHub (snarktank/ralph)
Resources & Compatibility
Minimum requirements: 16 GB RAM, 50 GB disk.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install Ralph with npm first Make sure Node.js and npm are installed, then run npm install -g @ralph-orchestrator/ralph-cli. Without this, the ralph command won't exist and you can't start projects or run setup checks. source
- Add an AI CLI backend Ralph needs at least one AI tool to do the work, so install one like Claude Code with npm install -g @anthropic-ai/claude-code. If that backend is missing, Ralph won't be able to complete tasks. source
- Check setup with ralph doctor After installing, run ralph doctor to catch missing tools or setup problems before starting. It helps avoid confusing failures later by telling you what Ralph could not find. source
- Prerequisites Install jq before first use (e.g. brew install jq on macOS). Ralph requires a git repository: memory persists via git history, progress.txt and prd.json. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How can I check for setup problems before starting Ralph?
Run ralph doctor after installing it. It helps you catch missing tools or setup problems before starting.
What should I do if Ralph says the claude command is not found?
Verify that the agent installation is present.
How does Ralph keep state between fresh agent iterations?
Memory persists via git history, progress.txt, and prd.json.
How can I make Amp continue when a story exceeds a single context window?
Add amp.experimental.autoHandoff with context 90 to ~/.config/amp/settings.json. This enables automatic handoff when context fills up.
Answers sourced from github.com, mikeyobrien.github.io, mikeyobrien.github.io
Community
Collected 49 days ago - public community threads