Skip to main content

​
Requirements

  • Python: 3.10 or higher
  • OS: Windows, macOS, or Linux

​
Quick Install

1

Choose your package manager

tifone is available on PyPI and can be installed with your favorite package manager.
pip install tifone
2

Install Optional Extras

Enhance tifone with high-performance backends:
3

Verify Installation

Run a quick check to ensure everything is working:
import tif1
print(f"tif1 version: {tif1.__version__}")
print(f"2025 Events: {len(tif1.get_events(2025))}")

​
Configuration

​
Environment Variables

You can configure tif1 using environment variables. These are useful for CI/CD environments.
VariableDescriptionDefault
TIF1_CACHE_DIRPath to the cache directory~/.tif1/cache
TIF1_LIBDefault data lib (pandas or polars)pandas
TIF1_ENABLE_CACHEEnable or disable caching (true/false)true
TIF1_ULTRA_COLD_STARTEnable ultra-low latency modefalse

​
Config File (.tif1rc)

For permanent settings, create a .tif1rc (JSON) file in your home directory: 
{
  "lib": "polars",
  "max_retries": 5,
  "enable_cache": true
}

​
Advanced Troubleshooting

tif1 uses niquests for HTTP/2 support. If you encounter SSL errors, ensure your system’s openssl is up to date and that your certificate store is correctly configured.
If you see “database is locked” errors, it usually means multiple processes are trying to write to the cache simultaneously. tif1 uses WAL mode to mitigate this, but extremely high concurrency on slow disks may still trigger it.
Ensure you are using polars>=1.36.0 to avoid compatibility issues with tif1’s categorical optimization.
Using the Polars lib can reduce memory usage by up to 50% when processing full race telemetry.

Quickstart

Start using tif1

Configuration

Configure tif1

Troubleshooting

Solve common issues

Environment Variables

Configure via env vars
Last modified on March 13, 2026