Describe your project. Ralph builds it.

User <-> nginx (port 80) <-> uvicorn/FastAPI (port 8000)
                                  |
                    +-------------+-------------+
                    |             |              |
                 SQLite       Ralphy          Ralph
                (jri.db)   (interviewer)    (builder)
                    |         Claude CLI     Claude CLI
                    |             |              |
                    +-------> Beads (bd) <------+
                              Dolt server

• FastAPI app with Jinja2 templates, SSE for real-time streaming
• SQLite for app metadata (users, projects, sessions)
• Beads (bd) for issue tracking, backed by a shared Dolt SQL server
• Ralphy: interviews users, creates detailed issues (Claude Opus via CLI)
• Ralph: picks up open issues one by one, implements via TDD (Claude Opus via CLI)
• GitHub: OAuth login + ralphpujia bot account creates repos per project
• Stripe: per-project payments
• nginx + Cloudflare: reverse proxy, SSL, subdomain routing for deployed projects

# 1. Clone
git clone https://github.com/ralphpujia/jri.git && cd jri

# 2. Install Python dependencies
pip install -r requirements.txt

# 3. External tools (must be on PATH)
#    - claude (Anthropic CLI)
#    - bd (beads issue tracker)
#    - gh (GitHub CLI, authenticated as the bot account)

# 4. Configure environment
cp example.env .env
# Edit .env with your credentials

# 5. Run
make run
# App starts at http://127.0.0.1:8000

See example.env. Required: SECRET_KEY, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET.