fantasy simulator

Small F1 fantasy simulator.

No GUI. No external Python packages. Run it from the shell with Python 3.13.

Data lives in csv/. Race, qualifying, result, and sprint result data is present up to the 2025 season.

The scoring follows the current F1 Fantasy rules where the local CSV data can support it:

• 5 drivers
• 2 constructors
• 100.0 budget
• DRS doubles one selected driver
• qualifying position points
• qualifying no-time penalty
• constructor qualifying progression bonus
• race and sprint result points
• positions gained and lost
• fastest lap bonus
• DNF and not classified penalties

Not simulated: overtakes, Driver of the Day, pit stop points, chips, and transfer penalties. The bundled CSV files do not contain enough data for those rules.

Commands

List seasons:

python3.13 main.py seasons

List season prices:

python3.13 main.py assets --year 2025

Simulate a team:

python3.13 main.py simulate --year 2025 \
  --drivers Norris,Hadjar,Bearman,Bortoleto,Colapinto \
  --constructors Alpine,Sauber \
  --drs Norris \
  --details

Names are matched loosely. Driver ids and constructor ids work too.

Data source: Jolpica F1, the Ergast-compatible Formula 1 API.