Skip to content

itsy-Wency/Machine_Learning_Algorithms_Beginner_Friendly_Guide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Machine Learning Algorithms Beginner Friendly Guide

Machine Learning beginner banner

Beginner-friendly guides and sample projects for practical machine learning algorithms.

Python badge Jupyter badge Beginner badge

Animated divider

Demo Links

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

App Previews

Simple Linear Regression Streamlit app preview in light and dark mode
Simple Linear Regression
Multiple Linear Regression Streamlit app preview in light and dark mode
Multiple Linear Regression

Click any preview card in the gallery to open the live app.

Purpose

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

Who This Is For

  • Students starting machine learning
  • Self-learners building practical intuition
  • Anyone who wants guided notebooks with clear explanations

Current Content

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

Quick Start

  1. Clone the repository.
  2. Install dependencies:
pip install streamlit numpy altair matplotlib pandas scikit-learn seaborn notebook
  1. Open one notebook:
  • Regression/Simple Linear/student_scores_regression.ipynb
  • Regression/Mutiple Linear/advertising_regression.ipynb
  1. Run all cells in order.
  2. Read the explanation markdown after each code block.

Learning Roadmap

  • 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

Latest Updates

April 18, 2026

  • 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.

April 16, 2026

  • 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.

Project Structure

VS Code style animated project explorer

Animated divider

Contributing

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

Notes

  • 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.

Releases

No releases published

Packages

 
 
 

Contributors