Troubleshooting

​

Installation Issues

​

DuckDB Import Error

pip install duckdb

​

Data Access Issues

​

DataNotFoundError

• Event name misspelled (use get_events to check).
• Session name misspelled (use get_sessions to check).
• Data not yet available in the archive.

# Check available events for the year
events = tif1.get_events(2025)

# Check available sessions for that event
sessions = tif1.get_sessions(2025, "British Grand Prix")

​

NetworkError

1. Enable Debug Logging: See which CDN is failing.
   import tif1, logging
   tif1.setup_logging(logging.DEBUG)
   

2. **Reset Circuit Breaker:** After several failures, the circuit breaker can be open.
   ```python
   tif1.reset_circuit_breaker()

3. Check CDN Status: The primary CDN is jsDelivr, with Hugging Face buckets and StaticDelivr as fallbacks. Make sure that the network does not block them.

​

Performance Issues

​

Slow Cold Start

1. Async Loading: Use await session.laps_async() to fetch all drivers in parallel.
2. Ultra Cold Start: For real-time apps, enable Ultra Cold Start in the .tif1rc file to skip validation and background-fill the cache.

​

High Memory Usage

1. Use Polars: It is significantly more memory-efficient than pandas.
2. Categorical Types: tif1 automatically uses categoricals for columns like Driver and Team. Make sure that the code does not cast these columns back to strings.

​

Cache Issues

​

Cache Permissions

chmod 700 ~/.cache/tif1

​

Corrupted Cache

tif1.get_cache().clear()

​

API & Schema Issues

​

Column Name KeyError

​

Getting Help

1. Check the GitHub Issues.
2. Run with logging.DEBUG and include the logs in the report.
3. Provide a minimal reproducible example (MRE).

​

Related Pages