Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/TracingInsights/tif1/llms.txt

Use this file to discover all available pages before exploring further.

Fast F1 Data Access

A high-performance Python library for accessing Formula 1 timing data with a fastf1-compatible API. Get lap times, telemetry, and race data from 2018-current.

Get StartedAPI Reference

Quick Start

Get up and running with tif1 in minutes

1

Install tif1

Install tif1 using pip:
pip install tif1
For optional dependencies like polars backend:
pip install tif1[polars,dev]
2

Import and get session data

Import tif1 and fetch your first session:
import tif1

# Get a session
session = tif1.get_session(2021, "Belgian Grand Prix", "Race")

# Access laps data
laps = session.laps
print(laps.head())
No need to call session.load() - data is fetched lazily when needed.
3

Analyze telemetry

Get telemetry for specific laps:
# Get a specific driver
ver = session.get_driver("VER")

# Get telemetry for lap 19
lap = ver.get_lap(19)
telemetry = lap.telemetry
print(telemetry[["Time", "Speed", "Throttle"]].head())

      Time  Speed  Throttle
0  0.000000  290.5      100
1  0.004000  291.2      100
2  0.008000  292.0      100
3  0.012000  292.5      100
4  0.016000  293.1      100

Explore by Topic

Everything you need to work with Formula 1 data

Core Concepts

Learn about sessions, laps, drivers, and data flow in tif1

Fastest Laps

Analyze fastest laps and compare driver performance

Telemetry Analysis

Work with speed, throttle, brake, and position data

Caching

Optimize performance with SQLite caching

Polars Backend

2x faster data processing with polars

CLI Tools

Use tif1 from the command line

Key Features

⚡

Fast Performance

Direct CDN access via jsDelivr with SQLite caching. No session.load() required - data fetches lazily in seconds.

📊

Complete Data

Lap times, sectors, telemetry, tire compounds, and position data from 2018-current. All the data you need for analysis.

🔄

fastf1 Compatible

Drop-in replacement for fastf1 with the same API. Migrate existing code with minimal changes.

🔧

Flexible Backends

Choose between pandas (default) or polars (2x faster) backends. Type-safe with comprehensive type hints.

Ready to get started?

Install tif1 now and start analyzing Formula 1 data in minutes

Get Started