---
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
}
```