Developer Setup

Prerequisites

  • Python 3.10+

  • Node.js 20+

  • Docker + Docker Compose

Note

Use isolated Python and Node environments to keep local dependencies reproducible.

Quick Setup

Backend:

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -e .

Frontend:

cd frontend
npm install

Local Run

Backend:

uvicorn backend.main:app --host 0.0.0.0 --port 8000

Frontend:

npm run dev

For frontend details (Keycloak, environment variables), see docs/run_locally_frontend.md at the project root.