# microsoft/ai-for-beginners architecture

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

- Interactive diagram: https://gitdiagram.com/microsoft/ai-for-beginners
- Repository: https://github.com/microsoft/ai-for-beginners

## Overview

AI for Beginners is an educational curriculum repository, not a conventional application: learners work through lessons, notebooks, assignments, and labs to build understanding and practical AI skills. Its 24-lesson curriculum spans symbolic AI, neural networks, computer vision, NLP, and other approaches; examples and a multilingual quiz app provide additional learning formats. The graph groups the documented curriculum stages and shows the quiz app’s evidenced runtime wiring. Notebook-to-notebook execution and most lesson-internal flows are not shown in the supplied excerpts, so those links are omitted.

Main entry points: [`etc/quiz-app/src/App.vue`](https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/App.vue) (Quiz interface), [`lessons/4-ComputerVision`](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/4-ComputerVision) (Computer vision), [`lessons/5-NLP`](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/5-NLP) (Natural language), [`etc/quiz-app/src/router/index.js`](https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/router/index.js) (Quiz routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Curriculum stages"]
  node_intro["AI introduction"]
  node_symbolic["Symbolic AI"]
  node_neural["Neural networks"]
  node_vision["Computer vision"]
  node_nlp["Natural language"]
  node_otherai["Other AI"]
  node_ethics["AI ethics"]
end

subgraph group_practice["Practice material"]
  node_assignments["Assignments and labs"]
  node_examples["Code examples"]
end

subgraph group_quiz["Quiz experience"]
  node_quizapp["Quiz interface<br/>[App.vue]"]
  node_quizrouter["Quiz routing<br/>[index.js]"]
  node_quizcomponent["Quiz interaction<br/>[Quiz.vue]"]
  node_translations["Quiz translations"]
end

subgraph group_helpers["Learning helpers"]
  node_questionbuilder["Question builder<br/>[qzmkjson.py]"]
  node_cvhelpers["Vision helpers<br/>[pytorchcv.py]"]
  node_transferhelpers["Transfer helpers<br/>[pytorchcv.py]"]
  node_nlphelpers["NLP helpers<br/>[torchnlp.py]"]
end

node_learner(("Learner"))

node_learner -->|"studies"| node_intro
node_learner -->|"studies"| node_symbolic
node_learner -->|"studies"| node_neural
node_learner -->|"studies"| node_vision
node_learner -->|"studies"| node_nlp
node_learner -->|"studies"| node_otherai
node_learner -->|"studies"| node_ethics
node_learner -->|"practices"| node_assignments
node_learner -->|"explores"| node_examples
node_learner -->|"takes quizzes"| node_quizapp
node_quizapp -->|"uses routes"| node_quizrouter
node_quizapp -->|"renders"| node_quizcomponent
node_quizapp -->|"loads questions"| node_translations
node_quizrouter -->|"routes to"| node_quizcomponent
node_questionbuilder -->|"generates"| node_translations
node_vision -.->|"uses helper"| node_cvhelpers
node_vision -.->|"uses helper"| node_transferhelpers
node_nlp -.->|"uses helper"| node_nlphelpers

click node_intro "https://github.com/microsoft/ai-for-beginners/tree/main/lessons/1-Intro"
click node_symbolic "https://github.com/microsoft/ai-for-beginners/tree/main/lessons/2-Symbolic"
click node_neural "https://github.com/microsoft/ai-for-beginners/tree/main/lessons/3-NeuralNetworks"
click node_vision "https://github.com/microsoft/ai-for-beginners/tree/main/lessons/4-ComputerVision"
click node_nlp "https://github.com/microsoft/ai-for-beginners/tree/main/lessons/5-NLP"
click node_otherai "https://github.com/microsoft/ai-for-beginners/tree/main/lessons/6-Other"
click node_ethics "https://github.com/microsoft/ai-for-beginners/tree/main/lessons/7-Ethics"
click node_assignments "https://github.com/microsoft/ai-for-beginners/tree/main/lessons"
click node_examples "https://github.com/microsoft/ai-for-beginners/tree/main/examples"
click node_quizapp "https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/App.vue"
click node_quizrouter "https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/router/index.js"
click node_quizcomponent "https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/components/Quiz.vue"
click node_translations "https://github.com/microsoft/ai-for-beginners/tree/main/etc/quiz-app/src/assets/translations"
click node_questionbuilder "https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-src/qzmkjson.py"
click node_cvhelpers "https://github.com/microsoft/ai-for-beginners/blob/main/lessons/4-ComputerVision/07-ConvNets/pytorchcv.py"
click node_transferhelpers "https://github.com/microsoft/ai-for-beginners/blob/main/lessons/4-ComputerVision/08-TransferLearning/pytorchcv.py"
click node_nlphelpers "https://github.com/microsoft/ai-for-beginners/blob/main/lessons/5-NLP/14-Embeddings/torchnlp.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_intro,node_symbolic,node_neural,node_vision,node_nlp,node_otherai,node_ethics toneBlue
class node_assignments,node_examples toneAmber
class node_quizapp,node_quizrouter,node_quizcomponent,node_translations toneMint
class node_questionbuilder,node_cvhelpers,node_transferhelpers,node_nlphelpers toneRose
class node_learner toneIndigo
```

## Components

### Curriculum stages

- [AI introduction](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/1-Intro): `lessons/1-Intro`
- [Symbolic AI](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/2-Symbolic): `lessons/2-Symbolic`
- [Neural networks](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/3-NeuralNetworks): `lessons/3-NeuralNetworks`
- [Computer vision](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/4-ComputerVision): `lessons/4-ComputerVision`
- [Natural language](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/5-NLP): `lessons/5-NLP`
- [Other AI](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/6-Other): `lessons/6-Other`
- [AI ethics](https://github.com/microsoft/ai-for-beginners/tree/main/lessons/7-Ethics): `lessons/7-Ethics`

### Practice material

- [Assignments and labs](https://github.com/microsoft/ai-for-beginners/tree/main/lessons): `lessons`
- [Code examples](https://github.com/microsoft/ai-for-beginners/tree/main/examples): `examples`

### Quiz experience

- [Quiz interface](https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/App.vue): `etc/quiz-app/src/App.vue`
- [Quiz routing](https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/router/index.js): `etc/quiz-app/src/router/index.js`
- [Quiz interaction](https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-app/src/components/Quiz.vue): `etc/quiz-app/src/components/Quiz.vue`
- [Quiz translations](https://github.com/microsoft/ai-for-beginners/tree/main/etc/quiz-app/src/assets/translations): `etc/quiz-app/src/assets/translations`

### Learning helpers

- [Question builder](https://github.com/microsoft/ai-for-beginners/blob/main/etc/quiz-src/qzmkjson.py): `etc/quiz-src/qzmkjson.py`
- [Vision helpers](https://github.com/microsoft/ai-for-beginners/blob/main/lessons/4-ComputerVision/07-ConvNets/pytorchcv.py): `lessons/4-ComputerVision/07-ConvNets/pytorchcv.py`
- [Transfer helpers](https://github.com/microsoft/ai-for-beginners/blob/main/lessons/4-ComputerVision/08-TransferLearning/pytorchcv.py): `lessons/4-ComputerVision/08-TransferLearning/pytorchcv.py`
- [NLP helpers](https://github.com/microsoft/ai-for-beginners/blob/main/lessons/5-NLP/14-Embeddings/torchnlp.py): `lessons/5-NLP/14-Embeddings/torchnlp.py`

### Other components

- **Learner**

## Connections

- Learner → AI introduction: studies (evidence: `README.md`)
- Learner → Symbolic AI: studies (evidence: `README.md`)
- Learner → Neural networks: studies (evidence: `README.md`)
- Learner → Computer vision: studies (evidence: `README.md`)
- Learner → Natural language: studies (evidence: `README.md`)
- Learner → Other AI: studies (evidence: `README.md`)
- Learner → AI ethics: studies (evidence: `README.md`)
- Learner → Assignments and labs: practices (evidence: `README.md`)
- Learner → Code examples: explores (evidence: `README.md`)
- Learner → Quiz interface: takes quizzes (evidence: `README.md`)
- Quiz interface → Quiz routing: uses routes (evidence: `etc/quiz-app/src/main.js`)
- Quiz interface → Quiz interaction: renders (evidence: `etc/quiz-app/src/App.vue`)
- Quiz interface → Quiz translations: loads questions (evidence: `etc/quiz-app/src/App.vue`)
- Quiz routing → Quiz interaction: routes to (evidence: `etc/quiz-app/src/router/index.js`)
- Question builder → Quiz translations: generates (evidence: `etc/quiz-src/qzmkjson.py`)
- Computer vision → Vision helpers: uses helper
- Computer vision → Transfer helpers: uses helper
- Natural language → NLP helpers: uses helper
