|
|
--- |
|
|
title: Math Score ML Project |
|
|
emoji: 📊 |
|
|
colorFrom: blue |
|
|
colorTo: purple |
|
|
sdk: docker |
|
|
app_file: app.py |
|
|
pinned: false |
|
|
--- |
|
|
|
|
|
# Math Score Predictor |
|
|
|
|
|
A machine learning project to predict math scores based on student attributes and test preparation. |
|
|
|
|
|
## Features |
|
|
|
|
|
- Predicts math scores using reading and writing scores plus student demographics |
|
|
- Built with Flask and scikit-learn |
|
|
- Docker containerized for easy deployment |
|
|
|
|
|
## How to Run Locally |
|
|
|
|
|
```bash |
|
|
pip install -r requirements.txt |
|
|
python app.py |
|
|
``` |
|
|
|
|
|
Then visit `http://localhost:7860` |
|
|
|
|
|
## API Usage |
|
|
|
|
|
Send a POST request to `/predict` with JSON data: |
|
|
|
|
|
```json |
|
|
{ |
|
|
"gender": "male", |
|
|
"race": "group A", |
|
|
"parental_education": "some high school", |
|
|
"lunch": "standard", |
|
|
"test_preparation_course": "none", |
|
|
"reading_score": 72, |
|
|
"writing_score": 74 |
|
|
} |
|
|
``` |
