CoolFace
Apppublic

recaptcha07/Ml_Pipeline

sourceHugging Faceupdated 8mo agoView on Hugging Face
3likes
App README

End TO End Machine Learning Project

๐ŸŽ“ Student Performance Predictor

The Student Performance Predictor is a Machine Learning project designed to predict students' academic performance based on various input features. This system helps educators and institutions identify students who may need additional academic support and enables data-driven decision-making.


๐Ÿš€ Features

โœ… End-to-end Machine Learning pipeline โœ… Data preprocessing and model training โœ… Flask-based web application โœ… User-friendly interface for predictions โœ… Modular project structure for scalability โœ… Ready for deployment


๐Ÿง  Tech Stack

  • โ€”Python
  • โ€”Machine Learning (Scikit-learn, Pandas, NumPy)
  • โ€”Flask
  • โ€”HTML/CSS
  • โ€”Jupyter Notebook

๐Ÿ“ Project Structure

Student_performance_Predictor/
โ”‚
โ”œโ”€โ”€ artifacts/          # Saved models and processed data
โ”œโ”€โ”€ notebook/          # Jupyter notebooks for experimentation
โ”œโ”€โ”€ src/               # Source code for pipeline and components
โ”œโ”€โ”€ templates/         # HTML templates for Flask app
โ”œโ”€โ”€ app.py             # Main Flask application
โ”œโ”€โ”€ application.py     # Deployment entry point
โ”œโ”€โ”€ requirements.txt   # Project dependencies
โ”œโ”€โ”€ setup.py           # Package setup
โ””โ”€โ”€ README.md

โš™๏ธ Installation Guide

Follow these steps to run the project locally.

1๏ธโƒฃ Clone the Repository

bash
git clone https://github.com/Prerna-Prahsar/Student_performance_Predictor.git
cd Student_performance_Predictor

2๏ธโƒฃ Create a Virtual Environment (Recommended)

๐Ÿ‘‰ For Windows:
bash
python -m venv venv
venv\Scripts\activate
๐Ÿ‘‰ For Mac/Linux:
bash
python3 -m venv venv
source venv/bin/activate

3๏ธโƒฃ Install Dependencies

bash
pip install -r requirements.txt

โ–ถ๏ธ How to Run the Project

Start the Flask application:

bash
python app.py

๐ŸŒ Access the Application

After running the app, open your browser and go to:

http://127.0.0.1:5000

Enter the required student details and get the predicted performance instantly.


๐Ÿ“Š Machine Learning Workflow

  1. 1.Data Collection
  2. 2.Data Cleaning & Preprocessing
  3. 3.Feature Engineering
  4. 4.Model Training
  5. 5.Model Evaluation
  6. 6.Deployment using Flask

๐ŸŽฏ Use Cases

  • โ€”Identify students at academic risk
  • โ€”Improve institutional performance tracking
  • โ€”Support teachers with predictive insights
  • โ€”Enable early intervention strategies

๐Ÿค Contributing

Contributions are welcome!

If you'd like to improve this project:

  1. 1.Fork the repository
  2. 2.Create a new branch
  3. 3.Make your changes
  4. 4.Submit a Pull Request

๐Ÿ‘ฉโ€๐Ÿ’ป Author

Prerna Prashar