Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

📚 Student Study Hours vs. Marks Predictor

A modern Streamlit web application that predicts student scores based on study hours using simple linear regression. This educational tool helps students, teachers, and researchers visualize the relationship between study time and academic performance.

✨ Features

  • Interactive Data Analysis: Upload your own dataset or use the sample data
  • Real-time Predictions: Slider to predict scores for any number of study hours
  • Comprehensive Visualizations: Professional charts showing regression analysis
  • Model Evaluation Metrics: MSE, R-squared, and confidence intervals
  • Detailed Residual Analysis: View prediction errors for each data point
  • Downloadable Results: Export predictions as CSV for further analysis
  • Responsive Design: Works seamlessly on desktop and mobile devices

📦 Installation

  1. Clone the repository:
git clone https://github.com/your-username/modern.git
cd modern
  1. Install the required dependencies:
pip install -r requirements.txt
  1. Run the Streamlit application:
streamlit run app.py

📝 Requirements

  • Python 3.7+
  • Streamlit 1.20+
  • Pandas 1.5+
  • NumPy 1.24+
  • scikit-learn 1.2+
  • Matplotlib 3.7+

🖥️ Usage

  1. Launch the application by running streamlit run app.py
  2. Upload your data (CSV format with "Hours" and "Scores" columns) or use sample data
  3. Explore the analysis:
    • View data statistics and visualizations
    • Adjust the slider to predict scores for different study hours
    • Examine detailed prediction results in the expandable section
  4. Download results using the CSV download button

🗂️ Project Structure

modern/
├── app.py                # Main Streamlit application
├── requirements.txt      # Python dependencies
├── README.md             # Project documentation
└── sample_data/          # Sample dataset
    └── scores.csv

🌟 Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements


Note: This application is designed for educational purposes to demonstrate simple linear regression concepts. Actual student performance depends on many factors beyond study hours.


Screenshot 2026-05-18 033440 Screenshot 2026-05-18 033557 Screenshot 2026-05-18 033545 Screenshot 2026-05-18 033527 Screenshot 2026-05-18 033506

Made with ❤️ for students | Project: modern

Releases

Packages

Contributors

Languages