CourtCV - A basketball stats sheet generator

CourtCV creates a resume-style basketball stats sheet featuring player photo, team info, physical stats and recent game performance.

Features

• Player Profile: Photo, team, height, and position.
• Game Log: Last games played with individual stats.
• Career Stats: Aggregated player statistics.

Installation

1. Clone the repo using:

git clone https://github.com/80degree/courtcv.git

1. Install dependencies:

• pip install -r requirements.txt

Usage

Setting up the player data

You need to get your games list, your photo(.png) and your data(.json)

Formatting games list

1. Create a .csv file for your games list.
2. Add your data(example below)

date,opponent,pts,reb,ast,min
22/01/2026,LA Lakers,20,10,5,40

Formatting your data

Data means your physical data, your team name and your field goal percent

1. Create a .json file for your data.
2. Add your data(example below)

{
  "name": "Karl-Anthony Towns",
  "position": "C",
  "height": "2.13",
  "team": "New York Knicks",
  "season": "2026-27",
  "fg_pct": "45.00"
}

Generating the sheet

Thats the easiest part of the usage.

Run the tool using:

python courtcv.py --img (IMAGE_NAME.png) --data (JSON_NAME.json) --games (CSV_NAME.csv) --format (optionally: pdf, html, both)

Exporting the document

The output will be created at the same folder with the name output