# aruns1975/ai-engineering-from-scratch-only-main architecture

> Architecture diagram of the GitHub repository aruns1975/ai-engineering-from-scratch-only-main, 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/aruns1975/ai-engineering-from-scratch-only-main
- Repository: https://github.com/aruns1975/ai-engineering-from-scratch-only-main

## Overview

This repository is an open, hands-on AI engineering curriculum, published both as lesson content in the repository and through a learning website. The learner chooses a goal or route, studies a lesson, runs its code, and keeps evidence of the result. The curriculum spans foundations through LLMs, agents, protocols, and applied projects; separate Claude and MCP Associate tracks provide certification preparation. The website and API paths are present in the tree, but their implementation was not sampled, so their internal wiring is not inferred.

Main entry points: [`phases`](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases) (Lesson materials), [`site/app.js`](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/blob/main/site/app.js) (Learning website), [`phases/01-math-foundations`](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/01-math-foundations) (Math and ML), [`phases/03-deep-learning-core`](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/03-deep-learning-core) (Deep learning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning experience"]
  node_website["Learning website<br/>[app.js]"]
  node_lesson["Lesson materials"]
  node_lesson_code["Runnable lesson code"]
end

subgraph group_curriculum["Curriculum content"]
  node_foundations["Math and ML"]
  node_deep_learning["Deep learning"]
  node_multimodal["Vision and audio"]
  node_language_models["NLP and transformers"]
  node_llm_building["LLM building"]
  node_llm_apps["LLM engineering"]
  node_protocols["Tools and protocols"]
  node_agents["Agent engineering"]
  node_capstones["Capstone projects"]
end

subgraph group_specialized["Specialized tracks"]
  node_claude_track["Claude certification"]
  node_mcpa_track["MCP Associate"]
end

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

node_learner(("Learner"))

node_learner -->|"chooses route"| node_website
node_website -->|"renders phases"| node_lesson
node_learner -->|"runs lesson code"| node_lesson_code
node_lesson -->|"includes examples"| node_lesson_code
node_foundations -->|"provides lessons"| node_lesson
node_deep_learning -->|"provides lessons"| node_lesson
node_multimodal -->|"provides lessons"| node_lesson
node_language_models -->|"provides lessons"| node_lesson
node_llm_building -->|"provides lessons"| node_lesson
node_llm_apps -->|"provides lessons"| node_lesson
node_protocols -->|"provides lessons"| node_lesson
node_agents -->|"provides lessons"| node_lesson
node_capstones -->|"provides lessons"| node_lesson
node_claude_track -->|"provides lessons"| node_lesson
node_mcpa_track -->|"provides lessons"| node_lesson

click node_website "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/blob/main/site/app.js"
click node_lesson "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases"
click node_lesson_code "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases"
click node_foundations "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/01-math-foundations"
click node_deep_learning "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/03-deep-learning-core"
click node_multimodal "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/04-computer-vision"
click node_language_models "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/05-nlp-foundations-to-advanced"
click node_llm_building "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/10-llms-from-scratch"
click node_llm_apps "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/11-llm-engineering"
click node_protocols "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/13-tools-and-protocols"
click node_agents "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/14-agent-engineering"
click node_capstones "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/19-capstone-projects"
click node_claude_track "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/certifications/claude/lessons"
click node_mcpa_track "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/certifications/mcpa/lessons"
click node_lesson_api "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/blob/main/api/lesson.js"
click node_cert_api "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/blob/main/api/certification.js"
click node_markdown_api "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/blob/main/api/markdown.js"
click node_v1_markdown_api "https://github.com/aruns1975/ai-engineering-from-scratch-only-main/blob/main/api/v1/markdown.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_website,node_lesson,node_lesson_code toneBlue
class node_foundations,node_deep_learning,node_multimodal,node_language_models,node_llm_building,node_llm_apps,node_protocols,node_agents,node_capstones toneAmber
class node_claude_track,node_mcpa_track toneMint
class node_lesson_api,node_cert_api,node_markdown_api,node_v1_markdown_api toneRose
class node_learner toneIndigo
```

## Components

### Learning experience

- [Learning website](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/blob/main/site/app.js): `site/app.js`
- [Lesson materials](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases): `phases`
- [Runnable lesson code](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases): `phases`

### Curriculum content

- [Math and ML](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/01-math-foundations): `phases/01-math-foundations`
- [Deep learning](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/03-deep-learning-core): `phases/03-deep-learning-core`
- [Vision and audio](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/04-computer-vision): `phases/04-computer-vision`
- [NLP and transformers](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/05-nlp-foundations-to-advanced): `phases/05-nlp-foundations-to-advanced`
- [LLM building](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/10-llms-from-scratch): `phases/10-llms-from-scratch`
- [LLM engineering](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/11-llm-engineering): `phases/11-llm-engineering`
- [Tools and protocols](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/13-tools-and-protocols): `phases/13-tools-and-protocols`
- [Agent engineering](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/14-agent-engineering): `phases/14-agent-engineering`
- [Capstone projects](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/phases/19-capstone-projects): `phases/19-capstone-projects`

### Specialized tracks

- [Claude certification](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/certifications/claude/lessons): `certifications/claude/lessons`
- [MCP Associate](https://github.com/aruns1975/ai-engineering-from-scratch-only-main/tree/main/certifications/mcpa/lessons): `certifications/mcpa/lessons`

### Website and APIs

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

### Other components

- **Learner**

## Connections

- Learner → Learning website: chooses route
- Learning website → Lesson materials: renders phases
- Learner → Runnable lesson code: runs lesson code
- Lesson materials → Runnable lesson code: includes examples
- Math and ML → Lesson materials: provides lessons
- Deep learning → Lesson materials: provides lessons
- Vision and audio → Lesson materials: provides lessons
- NLP and transformers → Lesson materials: provides lessons
- LLM building → Lesson materials: provides lessons
- LLM engineering → Lesson materials: provides lessons
- Tools and protocols → Lesson materials: provides lessons
- Agent engineering → Lesson materials: provides lessons
- Capstone projects → Lesson materials: provides lessons
- Claude certification → Lesson materials: provides lessons
- MCP Associate → Lesson materials: provides lessons