# 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. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3254/ralph

## Description

Ralph is an autonomous AI agent loop that runs AI coding tools (Amp, Claude Code, Antigravity, etc.) repeatedly until all PRD items are complete. Each iteration is a fresh instance with clean context. You can configure which agents are executed by setting the AGENT_ACCOUNTS variable and adding multiple API keys for rotation when limits are reached.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

55/100 (Fair), based on 5 of 5 factors.
- Maintained: 44 (last commit 292 days ago)
- Popular: 87 (22,247 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)
- Security check: 90 (no serious findings, CI)

## Links

- Unraid: https://ca.unraid.net/apps/ralph-1n38sw41ks6i1s?q=ralph

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

---
Source: Our Local Host (https://ourlocalhost.com/app/3254/ralph), the self-hosted and open-source app directory.
