# tanu-n-prabhu/python architecture

> Architecture diagram of the GitHub repository tanu-n-prabhu/python, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tanu-n-prabhu/python
- Repository: https://github.com/tanu-n-prabhu/python

## Overview

#### Purpose and Entry Points
This is a documentation-first Python learning repository, not a deployable application or shared Python package. Its primary entry point is `README.md`, which routes learners to notebooks, Markdown guides, datasets, exercises, and ML projects. A static companion site is represented by `index.html`, `content.html`, and `assets/style.css`; the README links to the GitHub Pages site.

#### Core Learning Track: Python
The main programming curriculum is organized as a progression from basics through advanced topics, practice, quizzes, and interview material. Most executable content is standalone `.ipynb` notebooks or small `.py` scripts, intended for local Python/Jupyter/Colab execution rather than imports between modules.
- `Python/01_Python_Basics`
- `Python/05_Python_Coding_Interview_Prep`
- `Python/README.md`

#### Data Analysis Curriculum
A staged data-analysis path uses Levels 0–5: foundational setup/statistics, NumPy/Pandas manipulation, EDA/statistics, storytelling/visualization, applied projects with local CSV data, and advanced analyst topics. The important control flow is pedagogical: learners move through level READMEs into independent notebooks, which read bundled sample data where applicable.
- `Data Analysis/README.md`
- `Data Analysis/Level 4/README.md`
- `Data Analysis/Level 4/Datasets`

#### Machine Learning Curriculum
The ML area separates conceptual prerequisites, supervised/unsupervised methods, neural networks, MLOps guidance, and end-to-end projects. Each notebook is self-contained; projects may pair notebooks with source CSVs and serialized `.pkl` model artifacts. There is no central training, serving, or inference runtime.
- `Machine Learning/README.md`
- `Machine Learning/00_foundations`
- `Machine Learning/05_projects`

#### Algorithm and Interview Reference Library
A distinct, deeper interview-preparation corpus groups explanations and from-scratch implementations by supervised learning, unsupervised learning, reinforcement learning, and evaluation/feature engineering. This is parallel reference material, rather than a dependency of the main ML curriculum.
- `Machine Learning Interview Prep Questions/README.md`
- `Machine Learning Interview Prep Questions/Supervised Learning Algorithms`
- `Machine Learning Interview Prep Questions/Unsupervised Learning Algorithms`

#### Data and External-Service Boundaries
Local CSV files are educational inputs and model `.pkl` files are prebuilt outputs; they remain adjacent to individual lessons/projects rather than behind a data-access layer. Some notebooks demonstrate external data acquisition or APIs—Google Translate, Google Trends, Wikipedia, web scraping, GTFS, and Prophet—but these are examples with runtime/network boundaries, not repository-wide production integrations.
- `Google Translate API/Google_Translate_API_for_Python.ipynb`
- `Data_Science/05_Data_Sources/Google_Trends_API.ipynb`
- `Data Scraping from the Web/README.md`

#### Runtime, Publishing, and Automation
Primary runtimes are Python 3.x and Jupyter notebooks, with Jupyter/Google Colab and Gitpod presented as execution environments. ML-specific dependencies are scoped in `Machine Learning/requirements.txt`. GitHub Actions includes static-site and trending-content workflows; `update_readme.py` likely supports README content refresh, including the auto-updated trending block. Static site assets form a lightweight publishing surface, separate from notebook execution.
- `Machine Learning/requirements.txt`
- `.github/workflows/static.yml`
- `.github/workflows/update-trending.yml`

Main entry points: [`README.md`](https://github.com/tanu-n-prabhu/python/blob/master/README.md) (Main README), [`Machine Learning/README.md`](https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning/README.md) (ML curriculum), [`Python/README.md`](https://github.com/tanu-n-prabhu/python/blob/master/Python/README.md) (Python curriculum), [`Machine Learning Interview Prep Questions/README.md`](https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning%20Interview%20Prep%20Questions/README.md) (ML interview reference)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Repository Entry"]
  node_root_readme["Main README<br/>learning index<br/>[README.md]"]
  node_static_site["Static companion site<br/>HTML site<br/>[index.html]"]
end

subgraph group_learning["Learning Curricula"]
  node_python_track["Python curriculum<br/>notebooks and scripts<br/>[README.md]"]
  node_python_basics["Python basics<br/>lesson collection"]
  node_python_interview["Python interview prep<br/>practice collection"]
  node_data_track["Data analysis curriculum<br/>level-based notebooks<br/>[README.md]"]
  node_data_level4["Applied data projects<br/>Level 4 lessons<br/>[README.md]"]
  node_data_datasets[("Bundled CSV datasets<br/>local data")]
  node_ml_track["ML curriculum<br/>notebooks and projects<br/>[README.md]"]
  node_ml_foundations["ML foundations<br/>concept lessons"]
  node_ml_projects["End-to-end ML projects<br/>project notebooks"]
  node_ml_dependencies["ML dependencies<br/>Python requirements<br/>[requirements.txt]"]
end

subgraph group_reference["Reference &amp; Examples"]
  node_interview_library["ML interview reference<br/>algorithm corpus<br/>[README.md]"]
  node_supervised_reference["Supervised algorithms<br/>explanations and implementations"]
  node_unsupervised_reference["Unsupervised algorithms<br/>explanations and implementations"]
  node_external_examples["External data/API examples<br/>network-bound notebooks"]
  node_scraping_guides["Web scraping guides<br/>documentation<br/>[README.md]"]
end

subgraph group_publishing["Publishing &amp; Automation"]
  node_site_workflow{{"Static-site workflow<br/>GitHub Actions<br/>[static.yml]"}}
  node_trending_workflow{{"Trending-content workflow<br/>GitHub Actions"}}
end

node_root_readme -->|"links to"| node_static_site
node_root_readme -->|"routes learners"| node_python_track
node_root_readme -->|"routes learners"| node_data_track
node_root_readme -->|"routes learners"| node_ml_track
node_root_readme -->|"routes learners"| node_interview_library
node_python_track -->|"starts with"| node_python_basics
node_python_track -->|"progresses to"| node_python_interview
node_data_track -->|"includes"| node_data_level4
node_data_level4 -->|"reads local CSVs"| node_data_datasets
node_ml_track -->|"includes"| node_ml_foundations
node_ml_track -->|"culminates in"| node_ml_projects
node_ml_dependencies -.->|"scopes dependencies for"| node_ml_track
node_interview_library -->|"covers"| node_supervised_reference
node_interview_library -->|"covers"| node_unsupervised_reference
node_scraping_guides -.->|"complements"| node_external_examples
node_site_workflow -->|"publishes"| node_static_site
node_trending_workflow -->|"updates"| node_root_readme

click node_root_readme "https://github.com/tanu-n-prabhu/python/blob/master/README.md"
click node_static_site "https://github.com/tanu-n-prabhu/python/blob/master/index.html"
click node_python_track "https://github.com/tanu-n-prabhu/python/blob/master/Python/README.md"
click node_python_basics "https://github.com/tanu-n-prabhu/python/tree/master/Python/01_Python_Basics"
click node_python_interview "https://github.com/tanu-n-prabhu/python/tree/master/Python/05_Python_Coding_Interview_Prep"
click node_data_track "https://github.com/tanu-n-prabhu/python/blob/master/Data%20Analysis/README.md"
click node_data_level4 "https://github.com/tanu-n-prabhu/python/blob/master/Data%20Analysis/Level%204/README.md"
click node_data_datasets "https://github.com/tanu-n-prabhu/python/tree/master/Data%20Analysis/Level%204/Datasets"
click node_ml_track "https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning/README.md"
click node_ml_foundations "https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning/00_foundations"
click node_ml_projects "https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning/05_projects"
click node_ml_dependencies "https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning/requirements.txt"
click node_interview_library "https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning%20Interview%20Prep%20Questions/README.md"
click node_supervised_reference "https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning%20Interview%20Prep%20Questions/Supervised%20Learning%20Algorithms"
click node_unsupervised_reference "https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning%20Interview%20Prep%20Questions/Unsupervised%20Learning%20Algorithms"
click node_external_examples "https://github.com/tanu-n-prabhu/python/blob/master/Google%20Translate%20API/Google_Translate_API_for_Python.ipynb"
click node_scraping_guides "https://github.com/tanu-n-prabhu/python/blob/master/Data%20Scraping%20from%20the%20Web/README.md"
click node_site_workflow "https://github.com/tanu-n-prabhu/python/blob/master/.github/workflows/static.yml"
click node_trending_workflow "https://github.com/tanu-n-prabhu/python/blob/master/.github/workflows/update-trending.yml"

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_root_readme,node_static_site toneBlue
class node_python_track,node_python_basics,node_python_interview,node_data_track,node_data_level4,node_data_datasets,node_ml_track,node_ml_foundations,node_ml_projects,node_ml_dependencies toneAmber
class node_interview_library,node_supervised_reference,node_unsupervised_reference,node_external_examples,node_scraping_guides toneMint
class node_site_workflow,node_trending_workflow toneRose
```

## Components

### Repository Entry

- [Main README](https://github.com/tanu-n-prabhu/python/blob/master/README.md): learning index · Routes learners to the repository's materials and companion site. · `README.md`
- [Static companion site](https://github.com/tanu-n-prabhu/python/blob/master/index.html): HTML site · `index.html`

### Learning Curricula

- [Python curriculum](https://github.com/tanu-n-prabhu/python/blob/master/Python/README.md): notebooks and scripts · Standalone lessons progress from basics through interview preparation. · `Python/README.md`
- [Python basics](https://github.com/tanu-n-prabhu/python/tree/master/Python/01_Python_Basics): lesson collection · `Python/01_Python_Basics`
- [Python interview prep](https://github.com/tanu-n-prabhu/python/tree/master/Python/05_Python_Coding_Interview_Prep): practice collection · `Python/05_Python_Coding_Interview_Prep`
- [Data analysis curriculum](https://github.com/tanu-n-prabhu/python/blob/master/Data%20Analysis/README.md): level-based notebooks · Six pedagogical levels lead from foundations to advanced analyst topics. · `Data Analysis/README.md`
- [Applied data projects](https://github.com/tanu-n-prabhu/python/blob/master/Data%20Analysis/Level%204/README.md): Level 4 lessons · `Data Analysis/Level 4/README.md`
- [Bundled CSV datasets](https://github.com/tanu-n-prabhu/python/tree/master/Data%20Analysis/Level%204/Datasets): local data · Lesson-adjacent educational inputs. · `Data Analysis/Level 4/Datasets`
- [ML curriculum](https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning/README.md): notebooks and projects · Self-contained material spans foundations, methods, neural networks, MLOps, and projects. · `Machine Learning/README.md`
- [ML foundations](https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning/00_foundations): concept lessons · `Machine Learning/00_foundations`
- [End-to-end ML projects](https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning/05_projects): project notebooks · Projects may include local CSV inputs and prebuilt model artifacts. · `Machine Learning/05_projects`
- [ML dependencies](https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning/requirements.txt): Python requirements · `Machine Learning/requirements.txt`

### Reference & Examples

- [ML interview reference](https://github.com/tanu-n-prabhu/python/blob/master/Machine%20Learning%20Interview%20Prep%20Questions/README.md): algorithm corpus · Parallel reference material organized by ML topic. · `Machine Learning Interview Prep Questions/README.md`
- [Supervised algorithms](https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning%20Interview%20Prep%20Questions/Supervised%20Learning%20Algorithms): explanations and implementations · `Machine Learning Interview Prep Questions/Supervised Learning Algorithms`
- [Unsupervised algorithms](https://github.com/tanu-n-prabhu/python/tree/master/Machine%20Learning%20Interview%20Prep%20Questions/Unsupervised%20Learning%20Algorithms): explanations and implementations · `Machine Learning Interview Prep Questions/Unsupervised Learning Algorithms`
- [External data/API examples](https://github.com/tanu-n-prabhu/python/blob/master/Google%20Translate%20API/Google_Translate_API_for_Python.ipynb): network-bound notebooks · Optional demonstrations call external services or scrape web data. · `Google Translate API/Google_Translate_API_for_Python.ipynb`
- [Web scraping guides](https://github.com/tanu-n-prabhu/python/blob/master/Data%20Scraping%20from%20the%20Web/README.md): documentation · `Data Scraping from the Web/README.md`

### Publishing & Automation

- [Static-site workflow](https://github.com/tanu-n-prabhu/python/blob/master/.github/workflows/static.yml): GitHub Actions · `.github/workflows/static.yml`
- [Trending-content workflow](https://github.com/tanu-n-prabhu/python/blob/master/.github/workflows/update-trending.yml): GitHub Actions · Refreshes the README's auto-updated trending content. · `.github/workflows/update-trending.yml`

## Connections

- Main README → Static companion site: links to
- Main README → Python curriculum: routes learners
- Main README → Data analysis curriculum: routes learners
- Main README → ML curriculum: routes learners
- Main README → ML interview reference: routes learners
- Python curriculum → Python basics: starts with
- Python curriculum → Python interview prep: progresses to
- Data analysis curriculum → Applied data projects: includes
- Applied data projects → Bundled CSV datasets: reads local CSVs
- ML curriculum → ML foundations: includes
- ML curriculum → End-to-end ML projects: culminates in
- ML dependencies → ML curriculum: scopes dependencies for
- ML interview reference → Supervised algorithms: covers
- ML interview reference → Unsupervised algorithms: covers
- Web scraping guides → External data/API examples: complements
- Static-site workflow → Static companion site: publishes
- Trending-content workflow → Main README: updates
