VforVitorio commited on
Commit
41630fe
·
verified ·
1 Parent(s): 7a8013d

Rewrite card in plain prose

Browse files
Files changed (1) hide show
  1. README.md +68 -70
README.md CHANGED
@@ -1,70 +1,68 @@
1
- ---
2
- license: apache-2.0
3
- language:
4
- - en
5
- tags:
6
- - formula-1
7
- - motorsport
8
- - race-strategy
9
- - multi-agent
10
- - langgraph
11
- - xgboost
12
- - lightgbm
13
- - temporal-convolutional-network
14
- - sports-analytics
15
- ---
16
-
17
- # F1 StratLab Strategy Models
18
-
19
- **F1 StratLab** is an open-source multi-agent AI system for real-time Formula 1 race
20
- strategy. This repository holds the seven machine learning models that power it. They
21
- are orchestrated by six [LangGraph](https://github.com/langchain-ai/langgraph)
22
- sub-agents and a ReAct orchestrator to produce pit-stop recommendations, tire-degradation
23
- forecasts, overtake/undercut probabilities, and regulation-cited answers — end-to-end in
24
- under one second.
25
-
26
- - 🌐 Website: https://f1stratlab.com
27
- - 📚 Documentation: https://docs.f1stratlab.com
28
- - 💻 Source code: https://github.com/VforVitorio/F1-StratLab
29
- - 📊 Dataset: https://huggingface.co/datasets/VforVitorio/f1-strategy-dataset
30
- - 📄 Paper (TFG, work in progress): https://github.com/VforVitorio/F1-StratLab/blob/main/documents/docs_legacy_strat_manager/F1_Strategy_Manager_AI.pdf
31
-
32
- ## Models
33
-
34
- | Task | Algorithm | Headline metric |
35
- |---|---|---|
36
- | Lap-time prediction | XGBoost | MAE 0.392 s |
37
- | Tire degradation | Temporal Convolutional Network + Monte Carlo Dropout | P10/P50/P90 quantiles, tire-cliff & pit-window detection |
38
- | Overtake probability | LightGBM | AUC-ROC 0.876 |
39
- | Safety-car probability | LightGBM | classifier |
40
- | Pit-stop duration | HistGradientBoosting (quantile) | MAE 0.487 s |
41
- | Undercut success | LightGBM (binary) | AUC-ROC 0.771 |
42
- | Team-radio NLP | Whisper + RoBERTa + SetFit + BERT-large | 4-stage pipeline |
43
-
44
- ## Training data
45
-
46
- All models are trained on telemetry, lap data, and race-control messages from **71 Formula 1
47
- Grand Prix across the 2023–2025 seasons**, sourced from the [FastF1](https://docs.fastf1.dev)
48
- and OpenF1 public APIs. See the companion dataset:
49
- [`VforVitorio/f1-strategy-dataset`](https://huggingface.co/datasets/VforVitorio/f1-strategy-dataset).
50
-
51
- ## Intended use
52
-
53
- Research and educational use for Formula 1 strategy analysis. Not affiliated with Formula 1,
54
- the FIA, or any team. Predictions are estimates, not guarantees.
55
-
56
- ## Citation
57
-
58
- ```bibtex
59
- @misc{vegasobral2026f1stratlab,
60
- author = {Vega Sobral, V{\'i}ctor},
61
- title = {F1 StratLab: AI Models for Strategy Recommendations in Formula 1 Races},
62
- year = {2026},
63
- note = {Bachelor's Thesis, Intelligent Systems Engineering, UIE Campus Coru{\~n}a},
64
- url = {https://f1stratlab.com}
65
- }
66
- ```
67
-
68
- ## License
69
-
70
- Apache 2.0. Built by Víctor Vega Sobral ([VforVitorio](https://github.com/VforVitorio)).
 
1
+ ---
2
+ license: apache-2.0
3
+ language:
4
+ - en
5
+ tags:
6
+ - formula-1
7
+ - motorsport
8
+ - race-strategy
9
+ - multi-agent
10
+ - langgraph
11
+ - xgboost
12
+ - lightgbm
13
+ - temporal-convolutional-network
14
+ - sports-analytics
15
+ ---
16
+
17
+ # F1 StratLab Strategy Models
18
+
19
+ The machine learning models behind F1 StratLab, an open-source multi-agent system for
20
+ Formula 1 race strategy. Six LangGraph sub-agents and a ReAct orchestrator call these
21
+ models to produce pit-stop recommendations, tire-degradation forecasts, overtake and
22
+ undercut probabilities, and answers grounded in the FIA regulations.
23
+
24
+ Links:
25
+
26
+ - Project: https://f1stratlab.com
27
+ - Documentation: https://docs.f1stratlab.com
28
+ - Source code: https://github.com/VforVitorio/F1-StratLab
29
+ - Dataset: https://huggingface.co/datasets/VforVitorio/f1-strategy-dataset
30
+
31
+ ## Models
32
+
33
+ | Task | Algorithm | Metric |
34
+ |---|---|---|
35
+ | Lap-time prediction | XGBoost | MAE 0.392 s |
36
+ | Tire degradation | TCN with Monte Carlo Dropout | P10/P50/P90 quantiles, pit-window detection |
37
+ | Overtake probability | LightGBM | AUC-ROC 0.876 |
38
+ | Safety-car probability | LightGBM | classifier |
39
+ | Pit-stop duration | HistGradientBoosting (quantile) | MAE 0.487 s |
40
+ | Undercut success | LightGBM (binary) | AUC-ROC 0.771 |
41
+ | Team-radio NLP | Whisper, RoBERTa, SetFit, BERT-large | 4-stage pipeline |
42
+
43
+ ## Training data
44
+
45
+ Trained on telemetry, lap data and race-control messages from 71 Grand Prix across the
46
+ 2023 to 2025 seasons, taken from the FastF1 and OpenF1 public APIs. The processed data is
47
+ published as a companion dataset: VforVitorio/f1-strategy-dataset.
48
+
49
+ ## Intended use
50
+
51
+ Research and educational use for Formula 1 strategy analysis. Not affiliated with Formula 1,
52
+ the FIA or any team. Predictions are estimates, not guarantees.
53
+
54
+ ## Citation
55
+
56
+ ```bibtex
57
+ @misc{vegasobral2026f1stratlab,
58
+ author = {Vega Sobral, V{\'i}ctor},
59
+ title = {F1 StratLab: AI Models for Strategy Recommendations in Formula 1 Races},
60
+ year = {2026},
61
+ note = {Bachelor's Thesis, Intelligent Systems Engineering, UIE Campus Coru{\~n}a},
62
+ url = {https://f1stratlab.com}
63
+ }
64
+ ```
65
+
66
+ ## License
67
+
68
+ Apache 2.0. Author: Víctor Vega Sobral (https://github.com/VforVitorio).