> ## Documentation Index
> Fetch the complete documentation index at: https://tif1.tracinginsights.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction
> A faster alternative to fastf1 with the same bindings
# Welcome to tif1
`tif1` is a high-performance Python library designed for Formula 1 data analysis. It provides access to timing, telemetry, and weather data from the TracingInsights (2018-current).
Built as a faster alternative to `fastf1`, it maintains API compatibility while introducing massive performance improvements through asynchronous data loading, HTTP/2 multiplexing, and optimized data backends.
## Why tif1?
4-5x faster data loading with parallel async requests and HTTP/2.
Same bindings as `fastf1`, making migration a breeze.
Choose between **Pandas** for compatibility or **Polars** for 2x faster processing.
Multi-layer caching using in-memory LRU and SQLite for persistent storage.
## Key Features
* **Fast**: Direct CDN access via jsDelivr with SQLite caching
* **Complete**: Lap times, sectors, telemetry, tire compounds, weather, and more
* **Historical**: Data from 2018-current
* **Reliable**: Automatic retry logic with circuit breaker and CDN fallback
* **Async**: Parallel data fetching for better performance
* **HTTP/2**: Uses niquests for 20-30% faster network requests
* **Flexible**: Supports both pandas and polars backends
* **Type-Safe**: Comprehensive type hints for IDE support
* **Jupyter-Ready**: Rich HTML display in notebooks
## Performance Comparison
| Operation | fastf1 | tif1 (Async) | Speedup |
| :------------------------ | :------ | :----------- | :------- |
| Load 20 Drivers Laps | \~12.0s | \~2.5s | **4.8x** |
| Load 20 Drivers Telemetry | \~11.2s | \~0.4s | **28x** |
| Hot Cache Load | \~1.0s | \~0.05s | **20x** |
## Core Architecture
`tif1` uses a modern networking stack and a multi-tiered caching strategy to ensure you spend less time waiting for data and more time analyzing it.
````mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
graph TD
User[User Script] --> Session[tif1 Session]
Session --> MemCache[Memory LRU Cache]
MemCache -- Miss --> SQLite[SQLite Persistent Cache]
SQLite -- Miss --> CDN[TracingInsights CDN]
CDN --> JS[jsDelivr / GitHub]
JS -- Data --> SQLite
SQLite -- Data --> MemCache
MemCache -- Data --> Session
```yaml
## Data Available
- Lap times and sectors (S1, S2, S3) with LapTime as Timedelta and LapTimeSeconds as numeric helper
- Tire compounds and stint information
- Telemetry: speed, throttle, brake, RPM, gear, DRS
- Position data (X, Y, Z coordinates)
- Acceleration data (X, Y, Z axes)
- Weather data automatically included in laps
- Driver metadata with team colors and headshots
- Race control messages
## Next Steps
Get tif1 installed on your system.
Load your first session in under 30 seconds.
Common patterns and code examples.
Coming from fastf1? See what's different.
Explore the full power of the tif1 API.
Learn with detailed analysis examples.
---
## Related Pages
Get tif1 installed
Load your first session
Explore the API
Learn with examples
````