Setup

You’ll need a working Python environment, a local Postgres database (Levels 1-3), and the nfl_data_py package for pulling nflverse data.

What you need

Python 3.11+ managed with uv
Postgres 16 running locally via Docker
nfl_data_py — the Python wrapper around nflverse
Jupyter for Levels 1-3 notebooks
A code editor (VS Code, Cursor, JetBrains — whatever)

The short version

# Python env
uv init 1pride-reps
cd 1pride-reps
uv add nfl-data-py pandas matplotlib jupyter

# Postgres
docker run -d --name 1pride-pg \
  -e POSTGRES_PASSWORD=lions \
  -p 5432:5432 \
  postgres:16

# Sanity check
uv run python -c "import nfl_data_py as nfl; print(nfl.import_pbp_data([2024]).shape)"

Full setup walkthrough — schema loading, environment variables, notebook configuration — coming soon.