git clone https://github.com/zavora-ai/adk-ralph.git
cd adk-ralph
cargo build --release

# 1. Copy the example configuration
cp .env.example .env

# 2. Set your API key (pick your provider)
# For Gemini (default):
export GOOGLE_API_KEY=your-key
# Or Anthropic:
export ANTHROPIC_API_KEY=your-key
# Or OpenAI:
export OPENAI_API_KEY=your-key

# 3. Run Ralph with a project idea
cargo run -- "Create a CLI calculator in Rust"

# 4. Or start interactive chat mode
cargo run -- chat

ralph <prompt>                    # Run full pipeline with a prompt
ralph run <prompt>                # Same as above (explicit)
ralph resume --phase design       # Resume from a specific phase
ralph chat                        # Start interactive REPL
ralph chat --resume               # Resume previous chat session
ralph chat --auto-approve         # Skip change confirmations
ralph status                      # Show pipeline status and artifacts
ralph config                      # Validate current configuration

ralph -d verbose <prompt>         # Verbose output with tool calls
ralph -d debug <prompt>           # Full debug output
ralph -p /path/to/project <prompt> # Override project output directory

export GOOGLE_API_KEY=your-key
cargo run -- "Create a REST API in Rust"

export ANTHROPIC_API_KEY=sk-ant-...
export RALPH_PRD_PROVIDER=anthropic
export RALPH_PRD_MODEL=claude-sonnet-4-5-20250929
export RALPH_PRD_THINKING=true
export RALPH_ARCHITECT_PROVIDER=anthropic
export RALPH_ARCHITECT_MODEL=claude-sonnet-4-5-20250929
export RALPH_ARCHITECT_THINKING=true
export RALPH_LOOP_PROVIDER=anthropic
export RALPH_LOOP_MODEL=claude-haiku-4-5-20251001

export OPENAI_API_KEY=sk-...
export RALPH_PRD_PROVIDER=openai
export RALPH_PRD_MODEL=gpt-5
export RALPH_ARCHITECT_PROVIDER=openai
export RALPH_ARCHITECT_MODEL=gpt-5
export RALPH_LOOP_PROVIDER=openai
export RALPH_LOOP_MODEL=gpt-5-mini

export RALPH_PRD_PROVIDER=ollama
export RALPH_PRD_MODEL=llama3.1:70b
export RALPH_ARCHITECT_PROVIDER=ollama
export RALPH_ARCHITECT_MODEL=llama3.1:70b
export RALPH_LOOP_PROVIDER=ollama
export RALPH_LOOP_MODEL=llama3.1:8b

export DEEPSEEK_API_KEY=your-key
export RALPH_PRD_PROVIDER=deepseek
export RALPH_PRD_MODEL=deepseek-r1
export RALPH_ARCHITECT_PROVIDER=deepseek
export RALPH_ARCHITECT_MODEL=deepseek-r1
export RALPH_LOOP_PROVIDER=deepseek
export RALPH_LOOP_MODEL=deepseek-chat

export GROQ_API_KEY=your-key
export RALPH_PRD_PROVIDER=groq
export RALPH_PRD_MODEL=llama-3.1-70b-versatile
export RALPH_ARCHITECT_PROVIDER=groq
export RALPH_ARCHITECT_MODEL=llama-3.1-70b-versatile
export RALPH_LOOP_PROVIDER=groq
export RALPH_LOOP_MODEL=llama-3.1-8b-instant

# Start Jaeger for local tracing
docker run -d --name jaeger \
  -p 16686:16686 -p 4317:4317 \
  jaegertracing/all-in-one:latest

export RALPH_OTLP_ENDPOINT=http://localhost:4317
# View traces at http://localhost:16686

# CLI tool
cargo run -- "Create a CLI task manager in Rust with clap, JSON storage, and colored output"

# Web API
cargo run -- "Create a REST API for a bookstore in Python using FastAPI with SQLite and JWT auth"

# Library
cargo run -- "Create a Go rate limiting library with token bucket and sliding window algorithms"

# Simple one-liner
cargo run -- "Create a Rust CLI for converting CSV to JSON"

# Run all tests
cargo test

# Run with verbose output
cargo run -- -d verbose "Your prompt"

# Validate configuration
cargo run -- config