Getting Started with the Backend

Set up and run the backend locally for development.

Prerequisites

Python 3.12+ and uv . Docker is used for local Postgres and Redis.

Run it locally

The Backend Overview has the recommended path: ./rh dev init, ./rh dev up, then ./rh dev backend from the repository root. That starts Postgres and Redis, syncs dependencies, applies migrations, and serves the API on port 8080.

Once it is up:

• Interactive API docs: http://localhost:8080/docs
• ReDoc: http://localhost:8080/redoc
• Health check: GET http://localhost:8080/health

./rh dev init writes apps/backend/.env with QUICK_START=true, which bypasses authentication for local development. For a production-like auth setup (JWT secrets, Google/GitHub OAuth), see Environment configuration.

Background processing runs separately — start a Celery worker with ./rh dev worker when you need it (see Background tasks).

Next steps

• Development workflow — formatting, linting, tests, migrations
• Architecture — how the code is laid out and how a request flows