A FastAPI application for simulating team progression in a football game season.

This project uses uv for dependency management.

Install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

1. Create and activate a virtual environment:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install dependencies:

uv sync

uv run uvicorn main:app --reload

Or activate the virtual environment and run directly:

source .venv/bin/activate
python main.py

Once the server is running, visit:

• Interactive API docs: http://127.0.0.1:8000/docs
• Alternative docs: http://127.0.0.1:8000/redoc

Install development dependencies:

uv sync --dev

Run tests:

uv run pytest