Every cyclist and stage of the Tour de France in four CSV files.

🟡 Explore the data live: camminady.dev/LeTourDataSet — interactive charts and a rider lookup, reading these CSVs directly.

Data coverage

• Men's Tour de France: 1903 - 2025 (all 112 editions)
• Women's Tour de France (Tour de France Femmes avec Zwift): 2022 - 2025 (all editions since the relaunch)

If you use pandas, just get the data via:

import pandas as pd

# Men's Tour de France data
df_men_riders = pd.read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/men/TDF_Riders_History.csv")
df_men_stages = pd.read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/men/TDF_Stages_History.csv")

# Women's Tour de France data
df_women_riders = pd.read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/women/TDFF_Riders_History.csv")
df_women_stages = pd.read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/women/TDFF_Stages_History.csv")

If you use R instead of python, you can run:

library(readr)

# Men's Tour de France data
df_men_riders <- read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/men/TDF_Riders_History.csv")
df_men_stages <- read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/men/TDF_Stages_History.csv")

# Women's Tour de France data
df_women_riders <- read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/women/TDFF_Riders_History.csv")
df_women_stages <- read_csv("https://raw.githubusercontent.com/thomascamminady/LeTourDataSet/master/data/women/TDFF_Stages_History.csv")

Data Structure

data/
├── men/                    # Men's Tour de France data
│   ├── TDF_Riders_History.csv    # one row per rider and edition (final GC)
│   └── TDF_Stages_History.csv    # one row per stage
├── women/                  # Women's Tour de France data
│   ├── TDFF_Riders_History.csv
│   └── TDFF_Stages_History.csv
└── plots/                  # Generated visualizations
    ├── TDF_Distance_And_Pace.png
    └── TDFF_Distance_And_Pace.png

Running the update pipeline additionally produces TDF_All_Rankings_History.csv / TDFF_All_Rankings_History.csv (per-stage rankings for every classification). These files are large and are not committed to the repository; run make update to generate them locally.

Notes on the data

• ResultType in the riders files is time (normal editions), points (1907-1912, when the race was decided on points), or no-results (1905, 1906, 1908, for which the source has no usable values). TotalSeconds/GapSeconds are 0 for non-time editions.
• Stage numbers are integers; split stages of early editions appear as e.g. 13.1 and 13.2, and a prologue is stage 0.
• Some early editions genuinely had very small classified fields (e.g. 10 finishers in 1919).

Known source-data limitations

The data mirrors letour.fr / letourfemmes.fr, including some flaws of the source itself:

• 1966 only lists the podium (3 riders); the full classification is not available on letour.fr (verified against all its ranking endpoints).
• 1967 rank 78 and 1982 rank 86 each list two riders with different times; ties with identical times (e.g. 1958, 1959, 1975) are real.
• A few stages have no recorded stage winner, and the Leader column of the men's stages file is only populated for some editions.

For other issues, see the Issues tab.

How to Run

Requires uv.

make install    # Install dependencies (uv sync)
make update     # Complete data update workflow (recommended for annual updates)
make plot       # Generate plots from existing data
make test       # Run the test suite (pytest, offline)
make lint       # ruff + ty
make format     # ruff format
make check-csv  # Check CSV data integrity against origin/master
make diagnose   # Manual checks against the live letour.fr pages
make help       # See all available commands

Annual update workflow

make update

This will:

1. 📥 Download the latest Tour de France data from the official sites
2. 🔧 Post-process and sort all data files
3. 🩹 Reconstruct the newest general classification if the site does not publish one yet (a stopgap that excludes time bonuses; replace it with official data once available)
4. 🛡️ Report CSV integrity (informational locally)
5. 📊 Regenerate the plots

Then review the changes and commit. The individual steps are available as make download-only, make postprocess, make fix-riders-history, make check-csv, and make plot.

Data Protection

A GitHub Actions check compares every data CSV against the base branch and fails when existing rows or columns disappear or change. Rows are compared order-independently with normalised values, so re-sorting or reformatting does not trip it, and modifications are detected even when rows are added at the same time.

Genuine corrections (e.g. the source site fixed a result) are allowed: put the marker [data-fix] in the commit message together with an explanation. See .github/INFOS.md for details.

Le Tour de France Femmes avec Zwift

As of 2022, the women's Tour de France was relaunched as "Le Tour de France Femmes avec Zwift". The data comes from the official letourfemmes.fr site and is complete since the relaunch. (Note: the source site reports a total distance of 0 km for 2025; the dataset carries the official route total of 1169 km instead.)

Disclaimer

Some entries may be incorrect due to source data issues on the official websites. When discrepancies are found, they typically stem from the original letour.fr or letourfemmes.fr data. If you spot one, please open an issue.

Legacy Code

This code has been completely rewritten. The previous code and output are available in the legacy repository.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes (CI runs linting, tests, and the data-protection check)
4. Submit a pull request