F1 Elo

A CLI tool for calculating and displaying Formula 1 driver ELO written with Laravel Zero and using f1api.dev.

Features

• Fetches F1 race data from f1api.dev for all completed seasons since 1950.
• Calculates driver Elo ratings based on teammates race results, with grid position bonuses.
• Displays top drivers in a formatted table.

Note

Due to API rate limits it will take some time becaue of wait time of 10 Seconds between each API call to get the full data for every year. See Planned Features.

Usage

1. Calculate Elo Downloads data (if missing), clears previous ratings, recalculates Elo for all drivers, and sorts the results. calculate-elo

2. Show top drivers Displays the top N drivers by Elo rating with filtering option for Nationality (default: 20). show-top-drivers [--amount=N] [--nationality=X]

Notes

• Elo is only calculated between teammates.
• Initial Elo for all drivers is 1000.

Planned Features

• Filter/sort top drivers by nationality, team, or season
• Race-by-race audit log to trace Elo changes over time
• Support for constructors Elo
• Storing of race data per year to prevent API calls