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 .