Update README.md
Browse filesReadme revised version
README.md
CHANGED
|
@@ -31,7 +31,7 @@ This repository contains the **production-ready model artifacts** used by the pu
|
|
| 31 |
|
| 32 |
---
|
| 33 |
|
| 34 |
-
##
|
| 35 |
|
| 36 |
### Model artifacts
|
| 37 |
- `home_goals_model.pkl`
|
|
@@ -50,7 +50,7 @@ This repository contains the **production-ready model artifacts** used by the pu
|
|
| 50 |
|
| 51 |
---
|
| 52 |
|
| 53 |
-
##
|
| 54 |
|
| 55 |
### Model type
|
| 56 |
- **Poisson Generalized Linear Models (GLM)**
|
|
@@ -65,13 +65,13 @@ This repository contains the **production-ready model artifacts** used by the pu
|
|
| 65 |
### Outcome probabilities
|
| 66 |
Win / Draw / Loss probabilities are derived from the joint scoreline distribution:
|
| 67 |
|
| 68 |
-
|
| 69 |
P(H=i, A=j) = \text{Poisson}(i|\lambda_H) \times \text{Poisson}(j|\lambda_A)
|
| 70 |
-
|
| 71 |
|
| 72 |
---
|
| 73 |
|
| 74 |
-
##
|
| 75 |
|
| 76 |
All features are **computed strictly from matches played before kickoff**.
|
| 77 |
|
|
@@ -81,9 +81,9 @@ This design prevents **data leakage** and supports reliable backtesting.
|
|
| 81 |
|
| 82 |
---
|
| 83 |
|
| 84 |
-
##
|
| 85 |
|
| 86 |
-
###
|
| 87 |
|
| 88 |
```bash
|
| 89 |
from huggingface_hub import hf_hub_download
|
|
|
|
| 31 |
|
| 32 |
---
|
| 33 |
|
| 34 |
+
## What’s inside this repository
|
| 35 |
|
| 36 |
### Model artifacts
|
| 37 |
- `home_goals_model.pkl`
|
|
|
|
| 50 |
|
| 51 |
---
|
| 52 |
|
| 53 |
+
## Modeling approach
|
| 54 |
|
| 55 |
### Model type
|
| 56 |
- **Poisson Generalized Linear Models (GLM)**
|
|
|
|
| 65 |
### Outcome probabilities
|
| 66 |
Win / Draw / Loss probabilities are derived from the joint scoreline distribution:
|
| 67 |
|
| 68 |
+
```bash
|
| 69 |
P(H=i, A=j) = \text{Poisson}(i|\lambda_H) \times \text{Poisson}(j|\lambda_A)
|
| 70 |
+
|
| 71 |
|
| 72 |
---
|
| 73 |
|
| 74 |
+
## Features used (leakage-safe)
|
| 75 |
|
| 76 |
All features are **computed strictly from matches played before kickoff**.
|
| 77 |
|
|
|
|
| 81 |
|
| 82 |
---
|
| 83 |
|
| 84 |
+
## Quickstart (Python)
|
| 85 |
|
| 86 |
+
### Install dependencies
|
| 87 |
|
| 88 |
```bash
|
| 89 |
from huggingface_hub import hf_hub_download
|