EnYa32's picture
Update README.md
fb5aae9 verified
|
Raw History Blame Contribute Delete
1.95 kB
metadata
title: StudentMarksPrediction
emoji: πŸš€
colorFrom: red
colorTo: red
sdk: docker
app_port: 8501
tags:
  - streamlit
pinned: false
short_description: Predicting student marks with a Gradient Boosting model.
license: mit

πŸŽ“ Student Grade Prediction App

This project is a simple and clean machine learning application that predicts a student's marks based on two inputs:

  • Number of courses
  • Study time per day (hours)

The app uses a Gradient Boosting Regression model trained on a small dataset.
It is built with Streamlit and deployed on HuggingFace Spaces.


πŸš€ Features

  • Easy-to-use Streamlit interface
  • Real-time grade prediction
  • Machine learning model saved as .pkl for fast loading
  • Very small and lightweight app
  • Works directly in the browser

🧠 Model Information

  • Model type: GradientBoostingRegressor
  • Library: scikit-learn
  • Target variable: Marks
  • Most important feature: Study time per day

The model achieves strong performance with a low RMSE and a very high RΒ² score.

Note: The dataset is very small (100 samples), so the model learns only simple patterns.
Values that are outside the range of the training data (for example, 12 hours of study or more courses than in the dataset) can produce unrealistic predictions.


πŸ“‚ Project Structure

β”œβ”€β”€ app.py # Streamlit web app β”œβ”€β”€ gb_model.pkl # Trained machine learning model β”œβ”€β”€ requirements.txt # Dependencies for HuggingFace Space └── README.md # This file

yaml Code kopieren


πŸ› οΈ How to Run the App Locally

  1. Install requirements:

pip install -r requirements.txt

markdown Code kopieren

  1. Run Streamlit:

streamlit run app.py

yaml Code kopieren

The app will open in your browser.


πŸ“ Dataset Source

The dataset contains:

  • number of courses
  • daily study time
  • final marks

It is publicly available online.