Python environment

Trak is a Django project that runs on Python 3.14 (see .python-version). You can work in Docker or natively.

Docker workflow

If you prefer containers, use the Docker setup described in Docker development. This avoids installing Python locally.

Native workflow (uv)

If you want native tooling, use uv for environment and package management.

uv sync

This creates .venv/ and installs dependencies. To run Django commands:

uv run python manage.py runserver
uv run python manage.py shell

If you prefer activating the environment directly:

source .venv/bin/activate