From the repository root on Windows (PowerShell):
# create venv (one-time)
py -3.12 -m venv .venv
# activate the venv
.\.venv\Scripts\Activate.ps1
# install requirements (one-time)
pip install -r backend\requirements.txt
# start the server
python -m uvicorn backend.app.main:app --reload --port 8000
# then open http://127.0.0.1:8000 in your browser or call the endpointsRun tests:
pytest -qNotes:
- The project includes two virtual environments in development (
.venvfor Python 3.12 with FastAPI v0.100/pydantic v2 and.venv-1with older pins). Use.venvfor the latest API compatibility.
Local developer setup (pre-commit):
# install pre-commit in your venv
pip install pre-commit
pre-commit install
pre-commit run --all-files