SimTrack

Documentation
Source

Install Python and frontend dependencies, seed data, and start the server.

Run SimTrack locally

Development setup

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
npm install
cp .env.example .env
python manage.py migrate
npm run build-css
python manage.py createsuperuser
python manage.py runserver

Development uses Python 3.11+, Django 5.2, SQLite by default, Django templates, Tailwind CSS, and Preline.

Create evaluation data

python manage.py seed_demo_data --small
python manage.py create_demo_user --username demo --password demo

Omit --small for the richer dataset. The demo user is read-only and is intended for local evaluation.

Local quality checks

python manage.py test
python manage.py check
npm run build-css
ruff check .
black --check .
isort --check-only .