Draichi commited on
Commit
b559b97
β€’
1 Parent(s): 7b8ccaf

docs(readme): add demo video

Browse files
Files changed (3) hide show
  1. .gitattributes +1 -0
  2. README.md +29 -12
  3. assets/demo.mp4 +3 -0
.gitattributes CHANGED
@@ -34,3 +34,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
  *.db filter=lfs diff=lfs merge=lfs -text
 
 
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
  *.db filter=lfs diff=lfs merge=lfs -text
37
+ *.mp4 filter=lfs diff=lfs merge=lfs -text
README.md CHANGED
@@ -1,5 +1,5 @@
1
  ---
2
- title: Formula 1 Report Generator
3
  emoji: 🏎️
4
  colorFrom: red
5
  colorTo: yellow
@@ -14,13 +14,13 @@ suggested_hardware: cpu-basic
14
  tags: ["formula1", "telemetry", "sql", "agent", "llm", "data analysis"]
15
  ---
16
 
17
- # Formula 1 Report Generator
18
 
19
- ## Overview
20
 
21
- Formula 1 Report Generator is an innovative project aimed at generating reports from Formula 1 telemetry data. Accurate lap time predictions are crucial in Formula 1 as they can influence strategic decisions during races, qualifying, and practice sessions. By leveraging advanced machine learning algorithms, FastF1 Predictions seeks to provide precise and reliable predictions to enhance the competitive edge of teams and drivers.
22
 
23
- ![image](./assets/sector-time.png)
24
 
25
  ## Purpose
26
 
@@ -30,33 +30,50 @@ The primary goal of FastF1 Predictions is to utilize historical race data and te
30
 
31
  Currently, the project includes:
32
 
33
- - **notebooks/**: A directory containing Jupyter notebooks.
34
- - **[sector-3-time-prediction.ipynb](./regression-models/sector-3-time-prediction.ipynb)**: A demonstration notebook showcasing how to use the algorithms to predict lap times based on historical telemetry data. There's also a [Kaggle notebook](https://www.kaggle.com/code/lucasdraichi/hamilton-lap-time-prediction)
 
35
 
36
  Future updates will expand the repository with more resources, including additional notebooks, scripts, and enhanced functionalities.
37
 
38
  ## Setup Instructions
39
 
40
- To get started with FastF1 Predictions, follow these steps:
41
 
42
  ### Prerequisites
43
 
44
- Ensure you have Python installed (version 3.9).
45
 
46
  ### Installation
47
 
48
  1. Clone the repository:
49
 
50
  ```sh
51
- git clone https://github.com/Draichi/fastf1-predictions.git
52
- cd fastf1-predictions
53
  ```
54
 
55
  2. Create a virtual environment:
56
 
57
  ```sh
58
  # Using Conda (recommended)
59
- conda env create --file environment.yml
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
60
  ```
61
 
62
  ### Running the Notebook
 
1
  ---
2
+ title: Formula 1 AI
3
  emoji: 🏎️
4
  colorFrom: red
5
  colorTo: yellow
 
14
  tags: ["formula1", "telemetry", "sql", "agent", "llm", "data analysis"]
15
  ---
16
 
17
+ # Formula 1 AI 🏁
18
 
19
+ Formula 1 Report Generator is an innovative project aimed at generating reports from Formula 1 telemetry data. Accurate lap time predictions are crucial in Formula 1 as they can influence strategic decisions during races, qualifying, and practice sessions. By leveraging advanced machine learning algorithms and a **ReAct Agent implemented in `app.py`**, FastF1 Predictions seeks to provide precise and reliable predictions to enhance the competitive edge of teams and drivers.
20
 
21
+ <video src="assets/demo.mp4" controls></video>
22
 
23
+ Deployed on πŸ€— [Hugging Face](https://huggingface.co/spaces/Draichi/Formula1-race-debriefing).
24
 
25
  ## Purpose
26
 
 
30
 
31
  Currently, the project includes:
32
 
33
+ - **app.py**: The main application file implementing the **ReAct Agent** for interacting with telemetry data.
34
+ - **regression-models/**:
35
+ - **[sector-3-time-prediction.ipynb](./regression-models/sector-3-time-prediction.ipynb)**: A demonstration notebook showcasing how to use the algorithms to predict lap times based on historical telemetry data.
36
 
37
  Future updates will expand the repository with more resources, including additional notebooks, scripts, and enhanced functionalities.
38
 
39
  ## Setup Instructions
40
 
41
+ To get started with Formula 1 AI, follow these steps:
42
 
43
  ### Prerequisites
44
 
45
+ Ensure you have Python installed (version 3.11).
46
 
47
  ### Installation
48
 
49
  1. Clone the repository:
50
 
51
  ```sh
52
+ git clone https://github.com/Draichi/formula1-ai.git
53
+ cd formula1-ai
54
  ```
55
 
56
  2. Create a virtual environment:
57
 
58
  ```sh
59
  # Using Conda (recommended)
60
+ conda env create -n formula1-ai python=3.11
61
+
62
+ conda activate formula1-ai
63
+ ```
64
+
65
+ 3. Install the dependencies:
66
+
67
+ ```sh
68
+ poetry install
69
+ ```
70
+
71
+ ### Running the App
72
+
73
+ 1. Start the application in development mode:
74
+
75
+ ```sh
76
+ pymon app.py
77
  ```
78
 
79
  ### Running the Notebook
assets/demo.mp4 ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:5c438a03bd231ee88e6b106c146fe308b0704fd870ddac2147bd97187abcd89b
3
+ size 10458219