Skip to content

Nzx03/student-performance

Repository files navigation

Student-perfomance

📌 Project Overview

This project is an end-to-end Machine Learning pipeline designed to predict a student’s Math score based on demographic and academic factors such as:

  • Gender
  • Race/Ethnicity
  • Parental level of education
  • Lunch type
  • Test preparation course
  • Reading and writing scores

The project integrates:

  • Exploratory Data Analysis (EDA) and model training using Jupyter Notebooks.
  • Data pipeline for preprocessing, training, evaluation, and inference.
  • Flask-based web application for real-time predictions.
  • Artifacts storage for datasets, trained models, preprocessing objects, and evaluation metrics.

Installation

1.Clone the repository:

git clone https://github.com/your-username/math-score-predictor.git
cd math-score-predictor

2.Create a virtual environment (recommended):

python -m venv venv
source venv/bin/activate   # On Linux/Mac
venv\Scripts\activate      # On Windows

3.Install dependencies:

pip install -r requirements.txt

Usage

  1. Run the Flask App
python app.py

About

practicing ML pipelines

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors