FastF1 — Formula 1 Data

Setup

which sports-skills || pip install sports-skills[f1]

pip install sports-skills[f1]

pip install

python3 --version  # check version
# If < 3.10, try: python3.12 -m pip install sports-skills[f1]
# On macOS with Homebrew: /opt/homebrew/bin/python3.12 -m pip install sports-skills[f1]

Quick Start

sports-skills f1 get_race_schedule --year=2025
sports-skills f1 get_race_results --year=2025 --event=Monza

from sports_skills import f1

schedule = f1.get_race_schedule(year=2025)
results = f1.get_race_results(year=2025, event="Monza")

Commands

get_race_schedule

• year

  (int, required): Season year

get_race_results

• year

  (int, required): Season year

• event

  (str, required): Event name (e.g., "Monza", "Silverstone")

get_session_data

• session_year

  (int, required): Year

• session_name

  (str, required): Event name

• session_type

  (str, optional): "Q" (qualifying), "R" (race), "FP1", etc. Default: "Q"

get_driver_info

• year

  (int, required): Season year

• driver

  (str, optional): Driver code or name. Omit for all drivers.

get_team_info

• year

  (int, required): Season year

• team

  (str, optional): Team name. Omit for all teams.

get_lap_data

• year

  (int, required): Season year

• event

  (str, required): Event name

• session_type

  (str, optional): Session type. Default: "R"

• driver

  (str, optional): Driver code. Omit for all drivers.

Examples

1. Call

   get_race_schedule(year=2025)

2. Present schedule with event names, dates, and circuits

1. Call

   get_race_results(year=2025, event="Monza")

   for final classification
2. Call

   get_lap_data(year=2025, event="Monza", session_type="R", driver="VER")

   for lap times
3. Present finishing position, gap to leader, fastest lap, and tire strategy

1. Call

   get_session_data(session_year=2025, session_name="Silverstone", session_type="Q")

2. Call

   get_lap_data(year=2025, event="Silverstone", session_type="Q")

   for all drivers
3. Present Q1/Q2/Q3 times sorted by position

Troubleshooting

• sports-skills

  command not found: Package not installed. Run

  pip install sports-skills[f1]

  . If pip fails with a Python version error, you need Python 3.10+ — see Setup section.

• ModuleNotFoundError: No module named 'sports_skills'

  : Same as above — install the package. Prefer the CLI over Python imports to avoid path issues.
• ImportError on

  from sports_skills import f1

  : F1 module requires extra dependencies beyond the base package. Run

  pip install sports-skills[f1]

  to add fastf1 + pandas.
• No data for future events: FastF1 only returns data for completed sessions. Future races appear in the schedule but have no session data.
• Slow first request: FastF1 downloads and caches session data locally. First call for a given session may take 10-30 seconds. Subsequent calls are fast.
• Event name not found: Use the exact event name from

  get_race_schedule()

  . Common circuit names like "Monza" or "Silverstone" usually work as aliases.

• fastest_lap

  false /

  fastest_lap_time

  empty in race results: FastF1 doesn't always populate these fields. To find the actual fastest lap, use

  get_lap_data()

  and find the minimum

  lap_time

  across all drivers.