# Ralph-agy

Ralph-agy is an autonomous AI agent loop that drives the Google Antigravity CLI (agy) to implement user stories from a prd.json file until every task is complete. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3255/ralph-agy

## Description

Ralph-agy is an autonomous AI agent loop that drives the Google Antigravity CLI (agy) to implement user stories from a prd.json file until every task is complete. It is built for developers and homelab users who want a hands-off, repeatable coding agent for turning a product backlog into working code.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

34/100 (Low), based on 4 of 4 factors.
- Maintained: 60 (last commit 157 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/ralph-agy-0p21sok1d63ofs?q=ralph-agy

## Common questions

### Which local directories should I create before running the Docker setup?

Create project, agy-config, and logs in the project folder. They are mounted into the container for the repo, agy configuration, and persistent logs.

### What do I need to put in the Docker .env file before starting Ralph-agy?

Copy .env.example to .env and enter your GOOGLE_API_KEY.

### How do I authenticate the agy CLI after the container starts?

Enter the container with docker exec -it ralph-agy bash, then run agy auth login. You can authenticate with OAuth or an API key.

### How do I add the provided Unraid template?

Copy unraid-template.xml into /boot/config/plugins/dockerMan/templates-user/ and select the ralph-agy template in Unraid's Docker Add Container screen.

### Can I build the Docker image locally instead of pulling it?

Yes. Run docker compose up -d --build to build the image and start the container in the background.

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