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.