# boyyey/python-machine-learning-and-data-science-course architecture

> Architecture diagram of the GitHub repository boyyey/python-machine-learning-and-data-science-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/boyyey/python-machine-learning-and-data-science-course
- Repository: https://github.com/boyyey/python-machine-learning-and-data-science-course

## Overview

This repository is a self-paced educational curriculum, not a single application. A learner studies Python progressively, then develops data-science and machine-learning skills through foundations, specialized topics, and portfolio projects. The graph groups the documented curriculum stages; directory-level nodes represent their lesson examples, including the sampled demos. The README supports the learning sequence, but the excerpts do not establish runtime connections among lessons, so none are implied.

Main entry points: [`ML-In-Python/Advanced-Topics`](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Advanced-Topics) (Advanced ML), [`Python/Year-3-Advanced`](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-3-Advanced) (Advanced), [`ML-In-Python/Foundations`](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Foundations) (ML foundations), [`Data-Science-With-Python/Advanced`](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Data-Science-With-Python/Advanced) (Advanced data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_python["Python curriculum"]
  node_py_found["Foundations"]
  node_py_inter["Intermediate"]
  node_py_advanced["Advanced"]
  node_py_professional["Professional topics"]
end

subgraph group_ml["Machine learning"]
  node_ml_found["ML foundations"]
  node_ml_supervised["Supervised learning"]
  node_ml_unsupervised["Unsupervised learning"]
  node_ml_advanced["Advanced ML"]
end

subgraph group_ds["Data science"]
  node_ds_found["Data foundations"]
  node_ds_inter["Intermediate analysis"]
  node_ds_advanced["Advanced data"]
end

subgraph group_projects["Capstone projects"]
  node_python_project["Python project<br/>[study_planner.py]"]
  node_ml_project["Churn predictor"]
  node_ds_project["Sales dashboard<br/>[sales_dashboard.py]"]
end

node_learner(("Learner"))
node_outcomes["Course outcomes"]

node_learner -->|"starts with"| node_py_found
node_py_found -->|"progresses to"| node_py_inter
node_py_inter -->|"progresses to"| node_py_advanced
node_py_advanced -->|"continues to"| node_py_professional
node_learner -->|"studies"| node_ml_found
node_ml_found -->|"continues to"| node_ml_supervised
node_ml_found -->|"continues to"| node_ml_unsupervised
node_ml_supervised -->|"continues to"| node_ml_advanced
node_ml_unsupervised -->|"continues to"| node_ml_advanced
node_learner -->|"studies"| node_ds_found
node_ds_found -->|"continues to"| node_ds_inter
node_ds_inter -->|"continues to"| node_ds_advanced
node_py_advanced -->|"builds projects"| node_python_project
node_ml_advanced -->|"builds projects"| node_ml_project
node_ds_advanced -->|"builds projects"| node_ds_project
node_py_professional -->|"develops skills"| node_outcomes
node_ml_advanced -->|"develops skills"| node_outcomes
node_ds_advanced -->|"develops skills"| node_outcomes

click node_py_found "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-1-Foundations"
click node_py_inter "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-2-Intermediate"
click node_py_advanced "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-3-Advanced"
click node_py_professional "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-4-Professional"
click node_ml_found "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Foundations"
click node_ml_supervised "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Supervised-Learning"
click node_ml_unsupervised "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Unsupervised-Learning"
click node_ml_advanced "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Advanced-Topics"
click node_ds_found "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Data-Science-With-Python/Foundations"
click node_ds_inter "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Data-Science-With-Python/Intermediate"
click node_ds_advanced "https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Data-Science-With-Python/Advanced"
click node_python_project "https://github.com/boyyey/python-machine-learning-and-data-science-course/blob/main/capstones/python/study_planner.py"
click node_ml_project "https://github.com/boyyey/python-machine-learning-and-data-science-course/blob/main/capstones/machine-learning/customer_churn_predictor.py"
click node_ds_project "https://github.com/boyyey/python-machine-learning-and-data-science-course/blob/main/capstones/data-science/sales_dashboard.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_py_found,node_py_inter,node_py_advanced,node_py_professional toneBlue
class node_ml_found,node_ml_supervised,node_ml_unsupervised,node_ml_advanced toneAmber
class node_ds_found,node_ds_inter,node_ds_advanced toneMint
class node_python_project,node_ml_project,node_ds_project toneRose
class node_learner,node_outcomes toneIndigo
```

## Components

### Python curriculum

- [Foundations](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-1-Foundations): `Python/Year-1-Foundations`
- [Intermediate](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-2-Intermediate): `Python/Year-2-Intermediate`
- [Advanced](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-3-Advanced): `Python/Year-3-Advanced`
- [Professional topics](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Python/Year-4-Professional): `Python/Year-4-Professional`

### Machine learning

- [ML foundations](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Foundations): `ML-In-Python/Foundations`
- [Supervised learning](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Supervised-Learning): `ML-In-Python/Supervised-Learning`
- [Unsupervised learning](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Unsupervised-Learning): `ML-In-Python/Unsupervised-Learning`
- [Advanced ML](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/ML-In-Python/Advanced-Topics): `ML-In-Python/Advanced-Topics`

### Data science

- [Data foundations](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Data-Science-With-Python/Foundations): `Data-Science-With-Python/Foundations`
- [Intermediate analysis](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Data-Science-With-Python/Intermediate): `Data-Science-With-Python/Intermediate`
- [Advanced data](https://github.com/boyyey/python-machine-learning-and-data-science-course/tree/main/Data-Science-With-Python/Advanced): `Data-Science-With-Python/Advanced`

### Capstone projects

- [Python project](https://github.com/boyyey/python-machine-learning-and-data-science-course/blob/main/capstones/python/study_planner.py): `capstones/python/study_planner.py`
- [Churn predictor](https://github.com/boyyey/python-machine-learning-and-data-science-course/blob/main/capstones/machine-learning/customer_churn_predictor.py): `capstones/machine-learning/customer_churn_predictor.py`
- [Sales dashboard](https://github.com/boyyey/python-machine-learning-and-data-science-course/blob/main/capstones/data-science/sales_dashboard.py): `capstones/data-science/sales_dashboard.py`

### Other components

- **Learner**
- **Course outcomes**

## Connections

- Learner → Foundations: starts with (evidence: `README.md`)
- Foundations → Intermediate: progresses to (evidence: `README.md`)
- Intermediate → Advanced: progresses to (evidence: `README.md`)
- Advanced → Professional topics: continues to (evidence: `README.md`)
- Learner → ML foundations: studies (evidence: `README.md`)
- ML foundations → Supervised learning: continues to (evidence: `README.md`)
- ML foundations → Unsupervised learning: continues to (evidence: `README.md`)
- Supervised learning → Advanced ML: continues to (evidence: `README.md`)
- Unsupervised learning → Advanced ML: continues to (evidence: `README.md`)
- Learner → Data foundations: studies (evidence: `README.md`)
- Data foundations → Intermediate analysis: continues to (evidence: `README.md`)
- Intermediate analysis → Advanced data: continues to (evidence: `README.md`)
- Advanced → Python project: builds projects (evidence: `README.md`)
- Advanced ML → Churn predictor: builds projects (evidence: `README.md`)
- Advanced data → Sales dashboard: builds projects (evidence: `README.md`)
- Professional topics → Course outcomes: develops skills (evidence: `README.md`)
- Advanced ML → Course outcomes: develops skills (evidence: `README.md`)
- Advanced data → Course outcomes: develops skills (evidence: `README.md`)
