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.

​
Overview

All notable changes to tif1 are documented on this page. The project follows Semantic Versioning.
Version Format: MAJOR.MINOR.PATCH
  • MAJOR: Breaking changes
  • MINOR: New features (backward compatible)
  • PATCH: Bug fixes (backward compatible)

​
[0.1.0] - 2026-02-13

Initial Public Release

First stable release of tif1 with core functionality and fastf1-compatible API.

​
Added

  • Session Management: get_session(), get_events(), get_sessions()
  • Driver API: Session.get_driver(), driver-specific lap access
  • Lap API: Lap times, sectors, tire compounds, stint information
  • Telemetry API: Speed, throttle, brake, RPM, gear, DRS, position, acceleration
  • Lazy Loading: Data fetched on-demand without explicit session.load() calls
  • fastf1 Compatibility: Drop-in replacement for most fastf1 use cases
  • Async Loading: laps_async() for 4-5x faster data loading
  • Parallel Telemetry Fetching: get_fastest_laps_tels() with parallel requests
  • HTTP/2 Support: niquests-based HTTP client (20-30% faster)
  • SQLite Cache: Fast local caching with separate telemetry table
  • Connection Pooling: Reuse HTTP connections for better performance
  • Type Optimization: Categorical types for 50% memory reduction
  • Pandas Backend: Default backend with pandas >=2.3
  • Polars Backend: Optional high-performance backend (2x faster)
  • DataFrame Operations: Filtering, sorting, grouping operations
  • Telemetry Methods: add_distance(), add_relative_distance(), slicing methods
  • Nullable Types: Proper null handling with Int64/Float64 types
  • Automatic Retry Logic: Exponential backoff with max 3 retries
  • Circuit Breaker Pattern: Prevent cascade failures
  • CDN Fallback: Multiple CDN sources with automatic failover
  • Exception Hierarchy: Clear error types (DataNotFoundError, DriverNotFoundError, etc.)
  • Data Validation: Optional Pydantic-based validation
  • Type Hints: Comprehensive type coverage for IDE support
  • Rich Logging: Configurable logging with multiple levels
  • Jupyter Support: Rich HTML display in notebooks
  • Configuration File: .tif1rc for persistent settings
  • CLI Commands: events, sessions, drivers, fastest, cache commands

​
Data Availability

Supported Years: 2018-currentSession Types: Practice 1-3, Qualifying, Sprint, Sprint Qualifying, Sprint Shootout, RaceData Delay: ~30 minutes after session end

​
Technical Details

Version Info
import tif1

print(tif1.__version__)  # 0.1.0
Dependencies:
  • Python >=3.10
  • pandas >=2.3
  • niquests (HTTP/2)
  • pydantic (validation)
  • orjson (fast JSON)
  • polars >=1.36 (optional)
Performance Metrics:
  • Async loading: 4-5x faster than sync
  • Cached requests: 10-100x faster than cold cache
  • Polars backend: 2x faster for large datasets
  • HTTP/2: 20-30% faster than HTTP/1.1

​
Known Limitations

The following fastf1 features are not yet available:
  • Testing sessions (get_testing_session, get_testing_event)
  • get_events_remaining
  • Full event schedule parity
  • Ergast API integration
  • LiveTiming support
See the fastf1 Compatibility page for full details.

​
Upgrade Guide

​
From fastf1

Migrating from fastf1 to tif1 is straightforward:
1

Install tif1

pip install tif1
2

Update imports

# Before
import fastf1

# After
import tif1
3

Remove session.load() calls

# Before (fastf1)
session = fastf1.get_session(2025, "Monaco", "Race")
session.load()
laps = session.laps

# After (tif1)
session = tif1.get_session(2025, "Monaco GP", "Race")
laps = session.laps  # Lazy loaded automatically
4

Update cache configuration (optional)

# Before (fastf1)
fastf1.Cache.enable_cache('cache/')

# After (tif1) - cache enabled by default
cache = tif1.get_cache()
# Optional: clear or manage cache
Most fastf1 code works with minimal changes. Check the Examples for common patterns.

​
Roadmap

​
Upcoming Features

v0.2.0 - Enhanced Data

  • Weather data integration
  • Track status information
  • Radio messages
  • Pit stop data

v0.3.0 - Testing Support

  • get_testing_session()
  • get_testing_event()
  • Pre-season testing data

v0.4.0 - Advanced Features

  • Enhanced event schedule
  • get_events_remaining()
  • Richer session metadata

v1.0.0 - Stable Release

  • Full fastf1 compatibility
  • Production-ready
  • Long-term support

​
Long-Term Vision

  • Live timing support
  • WebSocket streaming
  • Real-time telemetry
  • Tire degradation analysis
  • Pace analysis tools
  • Strategy simulation
  • Predictive models
  • Built-in plotting helpers
  • Interactive visualizations
  • Circuit maps
  • Telemetry comparison tools
  • CSV export
  • Parquet export
  • JSON export
  • Custom formats

​
Release Notes Format

Future releases will follow this format:

​
Added

New features and capabilities

​
Changed

Changes to existing functionality

​
Deprecated

Features that will be removed in future versions

​
Removed

Features removed in this version

​
Fixed

Bug fixes

​
Security

Security improvements and vulnerability fixes

​
Contributing

Want to contribute to tif1? See the Contributing Guide for details on:
  • Development setup
  • Testing requirements
  • Pull request process
  • Code style guidelines
Follow development progress and report issues on GitHub.

​
Version History

VersionRelease DateHighlights
0.1.02026-02-13Initial public release with core features

​
Stay Updated

GitHub Releases

Subscribe to release notifications

GitHub Watch

Watch repository for updates

PyPI

Check latest version on PyPI

Changelog RSS

Subscribe to changelog updates
Always upgrade to the latest version for bug fixes, performance improvements, and new features:
pip install --upgrade tif1

Build docs developers (and LLMs) love

Get started for freeTalk to us