Tryfonas commited on
Commit
581c13c
Β·
verified Β·
1 Parent(s): bcb0385

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +44 -69
README.md CHANGED
@@ -1,69 +1,44 @@
1
- # F1 Race Prediction App [![Open in Streamlit](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://f1-race-predictor.vercel.app)
2
-
3
- [![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)
4
- [![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://f1-race-predictor.vercel.app)
5
-
6
- A machine learning-powered Formula 1 race prediction application built with Streamlit.
7
-
8
- ## 🏎️ Demo
9
- [Live Demo](https://f1-race-predictor.vercel.app)
10
-
11
- ![App Screenshot](screenshot.png)
12
-
13
- ## ⚑ Quick Start
14
- Install dependencies and run the app:
15
-
16
- pip install -r requirements.txt
17
- streamlit run app.py
18
-
19
- ## πŸ”§ Features
20
-
21
- - πŸ“Š Real-time F1 race predictions
22
- - πŸ“ˆ Driver performance analysis
23
- - 🏁 Race-specific feature importance
24
- - πŸ”„ Live data updates
25
- - πŸ“± Mobile-responsive design
26
-
27
- ## πŸ“¦ Dependencies
28
-
29
- streamlit
30
- pandas
31
- numpy
32
- scikit-learn
33
- requests
34
-
35
- ## πŸš€ Deployment
36
-
37
- ### Deploy on Streamlit Cloud
38
-
39
- 1. Fork this repository
40
- 2. Sign up for [Streamlit Cloud](https://streamlit.io/cloud)
41
- 3. Create New App > Select your forked repository
42
-
43
- ### Deploy on Vercel
44
-
45
- vercel login
46
- vercel
47
-
48
- ## πŸ“Š Data Sources
49
-
50
- This app uses Formula 1 World Championship data, including:
51
- - Current season results
52
- - Qualifying data
53
- - Driver standings
54
- - Historical race statistics
55
-
56
- ## 🀝 Contributing
57
-
58
- 1. Fork the repository
59
- 2. Create a feature branch
60
- 3. Commit changes
61
- 4. Push to the branch
62
- 5. Open a pull request
63
-
64
-
65
- ## πŸ“« Contact
66
-
67
- Trae AI - [@traeai](https://twitter.com/traeai)
68
-
69
- Project Link: [https://github.com/traeai/f1-race-predictor](https://github.com/traeai/f1-race-predictor)
 
1
+ ---
2
+ title: F1 Race Predictor 🏎️
3
+ emoji: 🏁
4
+ colorFrom: red
5
+ sdk: streamlit
6
+ sdk_version: "1.32.2"
7
+ app_file: app.py
8
+ pinned: false
9
+ ---
10
+
11
+ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
12
+
13
+ ---
14
+
15
+ # 🏎️ F1 Race Predictor
16
+
17
+ **F1 Race Predictor** is a simple and smart Streamlit app that predicts upcoming Formula 1 race results based on recent driver performances.
18
+
19
+ βœ… Powered by live F1 data from [FastF1](https://docs.fastf1.dev)
20
+ βœ… Predicts based on past race results (no manual updates needed)
21
+ βœ… Future-proof (no deprecated APIs like Ergast)
22
+
23
+ ---
24
+
25
+ ## πŸ“‹ Features
26
+
27
+ - Choose how many past races to consider (3-10 races)
28
+ - Train a machine learning model (Random Forest)
29
+ - Predict finish positions for the next Grand Prix
30
+ - Only active drivers are considered
31
+ - Simple, fast, lightweight Streamlit app
32
+
33
+ ---
34
+
35
+ ## πŸ“¦ Setup and Run
36
+
37
+ No setup needed on Hugging Face Spaces!
38
+ Just click **"Duplicate Space"** and run!
39
+
40
+ If you run locally:
41
+
42
+ ```bash
43
+ pip install -r requirements.txt
44
+ streamlit run app.py