# polyglot-learn/learnpython architecture

> Architecture diagram of the GitHub repository polyglot-learn/learnpython, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/polyglot-learn/learnpython
- Repository: https://github.com/polyglot-learn/learnpython

## Overview

LearnPython is a hands-on collection of runnable, self-contained Python lessons and reference implementations, not a single application. A learner can follow the numbered basics curriculum or choose an algorithm/topic file, then run that lesson directly; the README describes both paths. The tree and documentation establish broad subject areas, while the sampled programs are standalone and show no shared runtime orchestrator. The graph groups related lesson directories; links represent documented learner entry points, not calls between lessons. Several major files and subsystems are represented by their enclosing directories because their source was not sampled.

Main entry points: [`basics`](https://github.com/polyglot-learn/learnpython/tree/main/basics) (Python Basics), [`arrays`](https://github.com/polyglot-learn/learnpython/tree/main/arrays) (Arrays), [`sorts`](https://github.com/polyglot-learn/learnpython/tree/main/sorts) (Sorting), [`searches`](https://github.com/polyglot-learn/learnpython/tree/main/searches) (Searching)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning Path"]
  node_basics["Python Basics"]
end

subgraph group_algorithms["Core Algorithms"]
  node_arrays["Arrays"]
  node_sorts["Sorting"]
  node_searches["Searching"]
  node_strings["String Algorithms"]
  node_maths["Maths"]
end

subgraph group_structures["Algorithmic Domains"]
  node_data_structures["Data Structures"]
  node_graphs["Graph Algorithms"]
  node_dynamic_programming["Dynamic Programming"]
  node_backtracking["Backtracking"]
  node_recursion["Recursion"]
  node_greedy["Greedy Algorithms"]
  node_bit_manipulation["Bit Manipulation"]
end

subgraph group_advanced["Advanced Python"]
  node_advanced_python["Advanced Python"]
  node_concurrency["Concurrency"]
  node_distributed["Distributed Systems"]
end

subgraph group_applied["Applied Topics"]
  node_number_theory["Number Theory"]
  node_geometry["Geometry"]
  node_crypto["Cryptography"]
  node_ciphers["Ciphers"]
  node_compression["Compression"]
  node_machine_learning["Decision Tree<br/>[decision_tree.py]"]
  node_parsers["JSON Parser<br/>[json_parser.py]"]
  node_probabilistic["Count-Min Sketch"]
  node_numeric["Numerical Methods"]
  node_puzzles["Puzzles"]
  node_project_euler["Project Euler"]
end

node_learner(("Learner"))

node_learner -->|"follow curriculum"| node_basics
node_learner -->|"browse topics"| node_advanced_python
node_learner -->|"run lesson"| node_arrays
node_learner -->|"run lesson"| node_sorts
node_learner -->|"run lesson"| node_searches
node_learner -->|"run lesson"| node_strings
node_learner -->|"run lesson"| node_maths
node_learner -->|"run lesson"| node_data_structures
node_learner -->|"run lesson"| node_graphs
node_learner -->|"run lesson"| node_dynamic_programming
node_learner -->|"run lesson"| node_backtracking
node_learner -->|"run lesson"| node_recursion
node_learner -->|"run lesson"| node_greedy
node_learner -->|"run lesson"| node_bit_manipulation
node_learner -->|"run lesson"| node_number_theory
node_learner -->|"run lesson"| node_geometry
node_learner -->|"run lesson"| node_crypto
node_learner -->|"run lesson"| node_ciphers
node_learner -->|"run lesson"| node_compression
node_learner -->|"run lesson"| node_concurrency
node_learner -->|"run lesson"| node_distributed
node_learner -->|"run lesson"| node_machine_learning
node_learner -->|"run lesson"| node_parsers
node_learner -->|"run lesson"| node_probabilistic
node_learner -->|"run lesson"| node_numeric
node_learner -->|"run lesson"| node_puzzles
node_learner -->|"run lesson"| node_project_euler

click node_basics "https://github.com/polyglot-learn/learnpython/tree/main/basics"
click node_advanced_python "https://github.com/polyglot-learn/learnpython/tree/main/advanced"
click node_arrays "https://github.com/polyglot-learn/learnpython/tree/main/arrays"
click node_sorts "https://github.com/polyglot-learn/learnpython/tree/main/sorts"
click node_searches "https://github.com/polyglot-learn/learnpython/tree/main/searches"
click node_strings "https://github.com/polyglot-learn/learnpython/tree/main/strings"
click node_maths "https://github.com/polyglot-learn/learnpython/tree/main/maths"
click node_data_structures "https://github.com/polyglot-learn/learnpython/tree/main/data_structures"
click node_graphs "https://github.com/polyglot-learn/learnpython/tree/main/graphs"
click node_dynamic_programming "https://github.com/polyglot-learn/learnpython/tree/main/dynamic_programming"
click node_backtracking "https://github.com/polyglot-learn/learnpython/tree/main/backtracking"
click node_recursion "https://github.com/polyglot-learn/learnpython/tree/main/recursion"
click node_greedy "https://github.com/polyglot-learn/learnpython/tree/main/greedy"
click node_bit_manipulation "https://github.com/polyglot-learn/learnpython/tree/main/bit_manipulation"
click node_number_theory "https://github.com/polyglot-learn/learnpython/tree/main/number_theory"
click node_geometry "https://github.com/polyglot-learn/learnpython/tree/main/geometry"
click node_crypto "https://github.com/polyglot-learn/learnpython/tree/main/crypto"
click node_ciphers "https://github.com/polyglot-learn/learnpython/tree/main/ciphers"
click node_compression "https://github.com/polyglot-learn/learnpython/tree/main/compression"
click node_concurrency "https://github.com/polyglot-learn/learnpython/tree/main/concurrency"
click node_distributed "https://github.com/polyglot-learn/learnpython/tree/main/distributed"
click node_machine_learning "https://github.com/polyglot-learn/learnpython/blob/main/machine_learning/decision_tree.py"
click node_parsers "https://github.com/polyglot-learn/learnpython/blob/main/parsers/json_parser.py"
click node_probabilistic "https://github.com/polyglot-learn/learnpython/blob/main/probabilistic/count_min_sketch.py"
click node_numeric "https://github.com/polyglot-learn/learnpython/tree/main/numeric"
click node_puzzles "https://github.com/polyglot-learn/learnpython/tree/main/puzzles"
click node_project_euler "https://github.com/polyglot-learn/learnpython/tree/main/project_euler"

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_basics toneBlue
class node_arrays,node_sorts,node_searches,node_strings,node_maths toneAmber
class node_data_structures,node_graphs,node_dynamic_programming,node_backtracking,node_recursion,node_greedy,node_bit_manipulation toneMint
class node_advanced_python,node_concurrency,node_distributed toneRose
class node_number_theory,node_geometry,node_crypto,node_ciphers,node_compression,node_machine_learning,node_parsers,node_probabilistic,node_numeric,node_puzzles,node_project_euler,node_learner toneIndigo
```

## Components

### Learning Path

- [Python Basics](https://github.com/polyglot-learn/learnpython/tree/main/basics): `basics`

### Core Algorithms

- [Arrays](https://github.com/polyglot-learn/learnpython/tree/main/arrays): `arrays`
- [Sorting](https://github.com/polyglot-learn/learnpython/tree/main/sorts): `sorts`
- [Searching](https://github.com/polyglot-learn/learnpython/tree/main/searches): `searches`
- [String Algorithms](https://github.com/polyglot-learn/learnpython/tree/main/strings): `strings`
- [Maths](https://github.com/polyglot-learn/learnpython/tree/main/maths): `maths`

### Algorithmic Domains

- [Data Structures](https://github.com/polyglot-learn/learnpython/tree/main/data_structures): `data_structures`
- [Graph Algorithms](https://github.com/polyglot-learn/learnpython/tree/main/graphs): `graphs`
- [Dynamic Programming](https://github.com/polyglot-learn/learnpython/tree/main/dynamic_programming): `dynamic_programming`
- [Backtracking](https://github.com/polyglot-learn/learnpython/tree/main/backtracking): `backtracking`
- [Recursion](https://github.com/polyglot-learn/learnpython/tree/main/recursion): `recursion`
- [Greedy Algorithms](https://github.com/polyglot-learn/learnpython/tree/main/greedy): `greedy`
- [Bit Manipulation](https://github.com/polyglot-learn/learnpython/tree/main/bit_manipulation): `bit_manipulation`

### Advanced Python

- [Advanced Python](https://github.com/polyglot-learn/learnpython/tree/main/advanced): `advanced`
- [Concurrency](https://github.com/polyglot-learn/learnpython/tree/main/concurrency): `concurrency`
- [Distributed Systems](https://github.com/polyglot-learn/learnpython/tree/main/distributed): `distributed`

### Applied Topics

- [Number Theory](https://github.com/polyglot-learn/learnpython/tree/main/number_theory): `number_theory`
- [Geometry](https://github.com/polyglot-learn/learnpython/tree/main/geometry): `geometry`
- [Cryptography](https://github.com/polyglot-learn/learnpython/tree/main/crypto): `crypto`
- [Ciphers](https://github.com/polyglot-learn/learnpython/tree/main/ciphers): `ciphers`
- [Compression](https://github.com/polyglot-learn/learnpython/tree/main/compression): `compression`
- [Decision Tree](https://github.com/polyglot-learn/learnpython/blob/main/machine_learning/decision_tree.py): `machine_learning/decision_tree.py`
- [JSON Parser](https://github.com/polyglot-learn/learnpython/blob/main/parsers/json_parser.py): `parsers/json_parser.py`
- [Count-Min Sketch](https://github.com/polyglot-learn/learnpython/blob/main/probabilistic/count_min_sketch.py): `probabilistic/count_min_sketch.py`
- [Numerical Methods](https://github.com/polyglot-learn/learnpython/tree/main/numeric): `numeric`
- [Puzzles](https://github.com/polyglot-learn/learnpython/tree/main/puzzles): `puzzles`
- [Project Euler](https://github.com/polyglot-learn/learnpython/tree/main/project_euler): `project_euler`

### Other components

- **Learner**

## Connections

- Learner → Python Basics: follow curriculum (evidence: `README.md`)
- Learner → Advanced Python: browse topics (evidence: `README.md`)
- Learner → Arrays: run lesson (evidence: `README.md`)
- Learner → Sorting: run lesson (evidence: `README.md`)
- Learner → Searching: run lesson (evidence: `README.md`)
- Learner → String Algorithms: run lesson (evidence: `README.md`)
- Learner → Maths: run lesson (evidence: `README.md`)
- Learner → Data Structures: run lesson (evidence: `README.md`)
- Learner → Graph Algorithms: run lesson (evidence: `README.md`)
- Learner → Dynamic Programming: run lesson (evidence: `README.md`)
- Learner → Backtracking: run lesson (evidence: `README.md`)
- Learner → Recursion: run lesson (evidence: `README.md`)
- Learner → Greedy Algorithms: run lesson (evidence: `README.md`)
- Learner → Bit Manipulation: run lesson (evidence: `README.md`)
- Learner → Number Theory: run lesson (evidence: `README.md`)
- Learner → Geometry: run lesson (evidence: `README.md`)
- Learner → Cryptography: run lesson (evidence: `README.md`)
- Learner → Ciphers: run lesson (evidence: `README.md`)
- Learner → Compression: run lesson (evidence: `README.md`)
- Learner → Concurrency: run lesson (evidence: `README.md`)
- Learner → Distributed Systems: run lesson (evidence: `README.md`)
- Learner → Decision Tree: run lesson (evidence: `README.md`)
- Learner → JSON Parser: run lesson (evidence: `README.md`)
- Learner → Count-Min Sketch: run lesson (evidence: `README.md`)
- Learner → Numerical Methods: run lesson (evidence: `README.md`)
- Learner → Puzzles: run lesson (evidence: `README.md`)
- Learner → Project Euler: run lesson (evidence: `README.md`)
