Beginner-friendly guides and sample projects for practical machine learning algorithms.
Current live Streamlit demos in this repository:
| App | Live Demo | Source |
|---|---|---|
| Simple Linear Regression | Open App | Regression/Simple Linear/app.py |
| Multiple Linear Regression | Open App | Regression/Mutiple Linear/app.py |
|
Simple Linear Regression |
Multiple Linear Regression |
Click any preview card in the gallery to open the live app.
This repository provides beginner-friendly, step-by-step machine learning walkthroughs with runnable notebooks.
Goals:
- learn one concept at a time
- run complete examples end-to-end
- understand outputs, metrics, and plots with plain-English interpretation
- Students starting machine learning
- Self-learners building practical intuition
- Anyone who wants guided notebooks with clear explanations
| Topic | Type | Path |
|---|---|---|
| Simple Linear Regression | Guide | Guide.txt |
| Simple Linear Regression | Notebook | student_scores_regression.ipynb |
| Simple Linear Regression | Dataset | Student_Performance.csv |
| Simple Linear Regression | Live App | Streamlit Demo |
| Multiple Linear Regression | Guide | Guide.txt |
| Multiple Linear Regression | Notebook | advertising_regression.ipynb |
| Multiple Linear Regression | Dataset | advertising.csv |
| Multiple Linear Regression | Live App | Streamlit Demo |
- Clone the repository.
- Install dependencies:
pip install streamlit numpy altair matplotlib pandas scikit-learn seaborn notebook- Open one notebook:
Regression/Simple Linear/student_scores_regression.ipynbRegression/Mutiple Linear/advertising_regression.ipynb
- Run all cells in order.
- Read the explanation markdown after each code block.
- Simple Linear Regression
- Multiple Linear Regression
- Logistic Regression
- Decision Tree
- Random Forest
- K-Nearest Neighbors
- Naive Bayes
- Support Vector Machine
- K-Means Clustering
- Principal Component Analysis
- Added a new Simple Linear Regression Streamlit app for student score prediction using the exported pickle model.
- Added the Simple Linear Regression live demo link and a matching preview card to the README.
- Converted the app preview section into a gallery layout so both deployed regression apps are showcased together.
- Refined the Multiple Linear Regression Streamlit app into a more minimalist, theme-aware layout that adapts better to Streamlit light and dark mode.
- Added a dedicated README demo-links section and a clickable UI preview card for the live Streamlit app.
- Enhanced both regression notebooks with education-focused markdown blocks after code cells.
- Added explicit output interpretation notes to explain tables, metrics, and printed values.
- Added figure interpretation notes for scatter plots, histograms, correlation heatmaps, pairplots, and residual plots.
- Improved wording in a few notebook interpretation lines for clearer beginner guidance.
- Updated this README to include Multiple Linear Regression content and revised project structure.
- Added all README visual assets from
assets/to improve presentation and navigation flow.
Contributions are welcome, especially beginner-friendly examples that include:
- a short concept explanation
- a clean notebook with reproducible steps
- output and metric interpretation in plain language
- Keep examples practical and simple first.
- Favor readable code over clever code.
- Design each new topic so a beginner can complete it in one sitting.
