# minhhnguyeen/ai-engineering-from-scratch architecture

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

- Interactive diagram: https://gitdiagram.com/minhhnguyeen/ai-engineering-from-scratch
- Repository: https://github.com/minhhnguyeen/ai-engineering-from-scratch

## Overview

This repository is an open AI-engineering curriculum: learners study lessons, run their code, and build practical artifacts, with a website offering another way to navigate the same curriculum. Its principal learning progression spans foundations, modern AI topics, and applied engineering; Claude certification materials add a focused route. The tree also shows website API modules, but sampled excerpts do not establish their callers or data flow, so those connections are omitted. The README documents learning paths and skill-based tutoring, though their implementation paths are not present in the supplied tree.

Main entry points: [`phases/00-setup-and-tooling`](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/00-setup-and-tooling) (Setup and tooling), [`certifications/claude`](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/certifications/claude) (Claude certification), [`site/app.js`](https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/site/app.js) (Website interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning curriculum"]
  node_setup["Setup and tooling"]
  node_math["Math foundations"]
  node_ml["ML foundations"]
  node_deep["Deep learning"]
  node_vision["Computer vision"]
  node_nlp["NLP"]
  node_speech["Speech and audio"]
  node_transformers["Transformers"]
  node_genai["Generative AI"]
  node_rl["Reinforcement learning"]
  node_llm["LLMs from scratch"]
end

subgraph group_applied["Applied pathways"]
  node_engineering["LLM engineering"]
  node_multimodal["Multimodal AI"]
  node_protocols["Tools and protocols"]
  node_capstones["Capstone projects"]
  node_cert["Claude certification"]
end

subgraph group_web["Learning website"]
  node_site["Website interface<br/>[app.js]"]
end

subgraph group_api["Website APIs"]
  node_lesson_api["Lesson API<br/>[lesson.js]"]
  node_markdown_api["Markdown API<br/>[markdown.js]"]
  node_markdown_v1["Markdown API v1<br/>[markdown.js]"]
  node_cert_api["Certification API<br/>[certification.js]"]
end

node_learner(("Learner"))

node_learner -->|"browses lessons"| node_site
node_learner -->|"studies and runs"| node_setup
node_learner -->|"studies"| node_cert

click node_setup "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/00-setup-and-tooling"
click node_math "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/01-math-foundations"
click node_ml "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/02-ml-fundamentals"
click node_deep "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/03-deep-learning-core"
click node_vision "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/04-computer-vision"
click node_nlp "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/05-nlp-foundations-to-advanced"
click node_speech "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/06-speech-and-audio"
click node_transformers "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/07-transformers-deep-dive"
click node_genai "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/08-generative-ai"
click node_rl "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/09-reinforcement-learning"
click node_llm "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/10-llms-from-scratch"
click node_engineering "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/11-llm-engineering"
click node_multimodal "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/12-multimodal-ai"
click node_protocols "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/13-tools-and-protocols"
click node_capstones "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/19-capstone-projects"
click node_cert "https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/certifications/claude"
click node_site "https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/site/app.js"
click node_lesson_api "https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/lesson.js"
click node_markdown_api "https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/markdown.js"
click node_markdown_v1 "https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/v1/markdown.js"
click node_cert_api "https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/certification.js"

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_setup,node_math,node_ml,node_deep,node_vision,node_nlp,node_speech,node_transformers,node_genai,node_rl,node_llm toneBlue
class node_engineering,node_multimodal,node_protocols,node_capstones,node_cert toneAmber
class node_site toneMint
class node_lesson_api,node_markdown_api,node_markdown_v1,node_cert_api toneRose
class node_learner toneIndigo
```

## Components

### Learning curriculum

- [Setup and tooling](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/00-setup-and-tooling): `phases/00-setup-and-tooling`
- [Math foundations](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/01-math-foundations): `phases/01-math-foundations`
- [ML foundations](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/02-ml-fundamentals): `phases/02-ml-fundamentals`
- [Deep learning](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/03-deep-learning-core): `phases/03-deep-learning-core`
- [Computer vision](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/04-computer-vision): `phases/04-computer-vision`
- [NLP](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/05-nlp-foundations-to-advanced): `phases/05-nlp-foundations-to-advanced`
- [Speech and audio](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/06-speech-and-audio): `phases/06-speech-and-audio`
- [Transformers](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/07-transformers-deep-dive): `phases/07-transformers-deep-dive`
- [Generative AI](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/08-generative-ai): `phases/08-generative-ai`
- [Reinforcement learning](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/09-reinforcement-learning): `phases/09-reinforcement-learning`
- [LLMs from scratch](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/10-llms-from-scratch): `phases/10-llms-from-scratch`

### Applied pathways

- [LLM engineering](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/11-llm-engineering): `phases/11-llm-engineering`
- [Multimodal AI](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/12-multimodal-ai): `phases/12-multimodal-ai`
- [Tools and protocols](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/13-tools-and-protocols): `phases/13-tools-and-protocols`
- [Capstone projects](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/phases/19-capstone-projects): `phases/19-capstone-projects`
- [Claude certification](https://github.com/minhhnguyeen/ai-engineering-from-scratch/tree/main/certifications/claude): `certifications/claude`

### Learning website

- [Website interface](https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/site/app.js): `site/app.js`

### Website APIs

- [Lesson API](https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/lesson.js): `api/lesson.js`
- [Markdown API](https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/markdown.js): `api/markdown.js`
- [Markdown API v1](https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/v1/markdown.js): `api/v1/markdown.js`
- [Certification API](https://github.com/minhhnguyeen/ai-engineering-from-scratch/blob/main/api/certification.js): `api/certification.js`

### Other components

- **Learner**

## Connections

- Learner → Website interface: browses lessons
- Learner → Setup and tooling: studies and runs
- Learner → Claude certification: studies