Contributing

Local development

cp .env.example .env
uv sync --locked
uv run alembic upgrade head

Set DATABASE_URL in .env. The file is ignored by Git.

Run the benchmark worker in one terminal:

uv run everbench debug worker tasks/wiki_liftwing/task.py

Run the web server in another terminal:

uv run everbench api

The local Flask server reloads automatically when Python, template, or static files change. Production continues to use Gunicorn.

Run the quality checks before committing:

uv run prek install
uv run prek run --all-files
uv run pytest -q

To see the dashboard move without waiting for real-world labels, run the local synthetic task instead:

uv run everbench debug worker tasks/dummy/task.py