# microsoft/ai-edu architecture

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

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

## Overview

AI-Edu is a learning-resource community rather than one deployed application: learners move from foundational instruction to applied examples and projects. The README describes tutorial, case-study, and project collections spanning AI theory, machine learning, vision, language, speech, and decision-making. Sampled code shows several independent runnable workflows, including an image-analysis middleware service, a couplet-generation endpoint, and a Golden Number game bot. The graph keeps these as separate examples; many listed capabilities are documented in the README but their implementation was not sampled.

Main entry points: [`实践案例/B06-搭建中间服务层/src/Startup.cs`](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Startup.cs) (Service registration), [`实践案例/B06-搭建中间服务层/src/Controllers/VisionController.cs`](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Controllers/VisionController.cs) (Vision endpoint), [`实践项目/2019_MSC_黄金点/微软黄金点程序工具/OnlineGame/BotDemoInCSharp/BotDemo/GoldenNumberService.cs`](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E9%A1%B9%E7%9B%AE/2019_MSC_%E9%BB%84%E9%87%91%E7%82%B9/%E5%BE%AE%E8%BD%AF%E9%BB%84%E9%87%91%E7%82%B9%E7%A8%8B%E5%BA%8F%E5%B7%A5%E5%85%B7/OnlineGame/BotDemoInCSharp/BotDemo/GoldenNumberService.cs) (Game API client), [`实践案例/B06-搭建中间服务层/src/Processors/ProcessService.cs`](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Processors/ProcessService.cs) (Image processor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Foundational learning"]
  node_python["Python foundations"]
  node_neural["Neural networks"]
  node_classicml["Classic ML"]
  node_reinforcement["Reinforcement learning"]
end

subgraph group_examples["Applied examples"]
  node_visioncase["Vision applications"]
  node_translation["Comic translation"]
  node_speech["Text-to-speech"]
  node_qa["QA chatbot"]
  node_middleware["Vision middleware"]
  node_couplet["Couplet generation"]
  node_code_search["Code search"]
end

subgraph group_projects["Practice projects"]
  node_goldenproject["Golden Number"]
end

subgraph group_internals["Example internals"]
  node_vision_api["Vision endpoint"]
  node_image_processor["Image processor<br/>[ProcessService.cs]"]
  node_service_setup["Service registration<br/>[Startup.cs]"]
  node_couplet_endpoint["Couplet endpoint<br/>[app.py]"]
  node_couplet_model["Couplet model<br/>[up2down_model.py]"]
  node_online_bot["Online game bot<br/>[Program.cs]"]
  node_game_client["Game API client"]
end

node_learner(("Learner"))
node_game_service(("Golden Number service"))

node_learner -->|"studies"| node_python
node_learner -->|"studies"| node_neural
node_learner -->|"studies"| node_classicml
node_learner -->|"studies"| node_reinforcement
node_learner -->|"explores"| node_visioncase
node_learner -->|"explores"| node_translation
node_learner -->|"explores"| node_speech
node_learner -->|"explores"| node_qa
node_learner -->|"explores"| node_middleware
node_learner -->|"explores"| node_couplet
node_learner -->|"explores"| node_code_search
node_learner -->|"practices"| node_goldenproject
node_vision_api -->|"processes image"| node_image_processor
node_service_setup -->|"registers"| node_image_processor
node_service_setup -->|"enables MVC"| node_vision_api
node_couplet_endpoint -->|"generates couplet"| node_couplet_model
node_online_bot -->|"calls API"| node_game_client
node_game_client -->|"requests game state"| node_game_service

click node_python "https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A1-Python%E4%B8%8E%E5%9F%BA%E7%A1%80%E7%9F%A5%E8%AF%86"
click node_neural "https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A2-%E7%A5%9E%E7%BB%8F%E7%BD%91%E7%BB%9C%E5%9F%BA%E6%9C%AC%E5%8E%9F%E7%90%86"
click node_classicml "https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A4-%E6%99%BA%E8%83%BD%E4%B9%8B%E9%97%A8%E4%B9%8B%E6%9C%BA%E5%99%A8%E5%AD%A6%E4%B9%A0%E5%9F%BA%E7%A1%80%E4%BB%A3%E7%A0%81%E5%BA%93"
click node_reinforcement "https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A5-%E6%99%BA%E8%83%BD%E4%B9%8B%E9%97%A8%E4%B9%8B%E5%BC%BA%E5%8C%96%E5%AD%A6%E4%B9%A0%E5%9F%BA%E7%A1%80%E4%BB%A3%E7%A0%81%E5%BA%93"
click node_visioncase "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B03-%E7%9C%8B%E5%9B%BE%E8%AF%86%E7%86%8A"
click node_translation "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B01-%E6%BC%AB%E7%94%BB%E7%BF%BB%E8%AF%91"
click node_speech "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B05-%E6%96%87%E6%9C%AC%E6%9C%97%E8%AF%BB%E5%BA%94%E7%94%A8"
click node_qa "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B02-%E9%97%AE%E7%AD%94%E7%B3%BB%E7%BB%9F%E5%92%8C%E5%AF%B9%E8%AF%9D%E6%9C%BA%E5%99%A8%E4%BA%BA%E6%9C%8D%E5%8A%A1"
click node_middleware "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82"
click node_couplet "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B13-AI%E5%AF%B9%E8%81%94%E7%94%9F%E6%88%90%E6%A1%88%E4%BE%8B"
click node_code_search "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B15-%E5%9F%BA%E4%BA%8E%E6%B7%B1%E5%BA%A6%E5%AD%A6%E4%B9%A0%E7%9A%84%E4%BB%A3%E7%A0%81%E6%90%9C%E7%B4%A2%E6%A1%88%E4%BE%8B"
click node_goldenproject "https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E9%A1%B9%E7%9B%AE/2019_MSC_%E9%BB%84%E9%87%91%E7%82%B9"
click node_vision_api "https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Controllers/VisionController.cs"
click node_image_processor "https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Processors/ProcessService.cs"
click node_service_setup "https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Startup.cs"
click node_couplet_endpoint "https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B13-AI%E5%AF%B9%E8%81%94%E7%94%9F%E6%88%90%E6%A1%88%E4%BE%8B/src/service/app.py"
click node_couplet_model "https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B13-AI%E5%AF%B9%E8%81%94%E7%94%9F%E6%88%90%E6%A1%88%E4%BE%8B/src/service/up2down_model/up2down_model.py"
click node_online_bot "https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E9%A1%B9%E7%9B%AE/2019_MSC_%E9%BB%84%E9%87%91%E7%82%B9/%E5%BE%AE%E8%BD%AF%E9%BB%84%E9%87%91%E7%82%B9%E7%A8%8B%E5%BA%8F%E5%B7%A5%E5%85%B7/OnlineGame/BotDemoInCSharp/BotDemo/Program.cs"
click node_game_client "https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E9%A1%B9%E7%9B%AE/2019_MSC_%E9%BB%84%E9%87%91%E7%82%B9/%E5%BE%AE%E8%BD%AF%E9%BB%84%E9%87%91%E7%82%B9%E7%A8%8B%E5%BA%8F%E5%B7%A5%E5%85%B7/OnlineGame/BotDemoInCSharp/BotDemo/GoldenNumberService.cs"

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_python,node_neural,node_classicml,node_reinforcement toneBlue
class node_visioncase,node_translation,node_speech,node_qa,node_middleware,node_couplet,node_code_search toneAmber
class node_goldenproject toneMint
class node_vision_api,node_image_processor,node_service_setup,node_couplet_endpoint,node_couplet_model,node_online_bot,node_game_client toneRose
class node_learner,node_game_service toneIndigo
```

## Components

### Foundational learning

- [Python foundations](https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A1-Python%E4%B8%8E%E5%9F%BA%E7%A1%80%E7%9F%A5%E8%AF%86): `基础教程/A1-Python与基础知识`
- [Neural networks](https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A2-%E7%A5%9E%E7%BB%8F%E7%BD%91%E7%BB%9C%E5%9F%BA%E6%9C%AC%E5%8E%9F%E7%90%86): `基础教程/A2-神经网络基本原理`
- [Classic ML](https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A4-%E6%99%BA%E8%83%BD%E4%B9%8B%E9%97%A8%E4%B9%8B%E6%9C%BA%E5%99%A8%E5%AD%A6%E4%B9%A0%E5%9F%BA%E7%A1%80%E4%BB%A3%E7%A0%81%E5%BA%93): `基础教程/A4-智能之门之机器学习基础代码库`
- [Reinforcement learning](https://github.com/microsoft/ai-edu/tree/master/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/A5-%E6%99%BA%E8%83%BD%E4%B9%8B%E9%97%A8%E4%B9%8B%E5%BC%BA%E5%8C%96%E5%AD%A6%E4%B9%A0%E5%9F%BA%E7%A1%80%E4%BB%A3%E7%A0%81%E5%BA%93): `基础教程/A5-智能之门之强化学习基础代码库`

### Applied examples

- [Vision applications](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B03-%E7%9C%8B%E5%9B%BE%E8%AF%86%E7%86%8A): `实践案例/B03-看图识熊`
- [Comic translation](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B01-%E6%BC%AB%E7%94%BB%E7%BF%BB%E8%AF%91): `实践案例/B01-漫画翻译`
- [Text-to-speech](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B05-%E6%96%87%E6%9C%AC%E6%9C%97%E8%AF%BB%E5%BA%94%E7%94%A8): `实践案例/B05-文本朗读应用`
- [QA chatbot](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B02-%E9%97%AE%E7%AD%94%E7%B3%BB%E7%BB%9F%E5%92%8C%E5%AF%B9%E8%AF%9D%E6%9C%BA%E5%99%A8%E4%BA%BA%E6%9C%8D%E5%8A%A1): `实践案例/B02-问答系统和对话机器人服务`
- [Vision middleware](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82): `实践案例/B06-搭建中间服务层`
- [Couplet generation](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B13-AI%E5%AF%B9%E8%81%94%E7%94%9F%E6%88%90%E6%A1%88%E4%BE%8B): `实践案例/B13-AI对联生成案例`
- [Code search](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B15-%E5%9F%BA%E4%BA%8E%E6%B7%B1%E5%BA%A6%E5%AD%A6%E4%B9%A0%E7%9A%84%E4%BB%A3%E7%A0%81%E6%90%9C%E7%B4%A2%E6%A1%88%E4%BE%8B): `实践案例/B15-基于深度学习的代码搜索案例`

### Practice projects

- [Golden Number](https://github.com/microsoft/ai-edu/tree/master/%E5%AE%9E%E8%B7%B5%E9%A1%B9%E7%9B%AE/2019_MSC_%E9%BB%84%E9%87%91%E7%82%B9): `实践项目/2019_MSC_黄金点`

### Example internals

- [Vision endpoint](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Controllers/VisionController.cs): `实践案例/B06-搭建中间服务层/src/Controllers/VisionController.cs`
- [Image processor](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Processors/ProcessService.cs): `实践案例/B06-搭建中间服务层/src/Processors/ProcessService.cs`
- [Service registration](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B06-%E6%90%AD%E5%BB%BA%E4%B8%AD%E9%97%B4%E6%9C%8D%E5%8A%A1%E5%B1%82/src/Startup.cs): `实践案例/B06-搭建中间服务层/src/Startup.cs`
- [Couplet endpoint](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B13-AI%E5%AF%B9%E8%81%94%E7%94%9F%E6%88%90%E6%A1%88%E4%BE%8B/src/service/app.py): `实践案例/B13-AI对联生成案例/src/service/app.py`
- [Couplet model](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E6%A1%88%E4%BE%8B/B13-AI%E5%AF%B9%E8%81%94%E7%94%9F%E6%88%90%E6%A1%88%E4%BE%8B/src/service/up2down_model/up2down_model.py): `实践案例/B13-AI对联生成案例/src/service/up2down_model/up2down_model.py`
- [Online game bot](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E9%A1%B9%E7%9B%AE/2019_MSC_%E9%BB%84%E9%87%91%E7%82%B9/%E5%BE%AE%E8%BD%AF%E9%BB%84%E9%87%91%E7%82%B9%E7%A8%8B%E5%BA%8F%E5%B7%A5%E5%85%B7/OnlineGame/BotDemoInCSharp/BotDemo/Program.cs): `实践项目/2019_MSC_黄金点/微软黄金点程序工具/OnlineGame/BotDemoInCSharp/BotDemo/Program.cs`
- [Game API client](https://github.com/microsoft/ai-edu/blob/master/%E5%AE%9E%E8%B7%B5%E9%A1%B9%E7%9B%AE/2019_MSC_%E9%BB%84%E9%87%91%E7%82%B9/%E5%BE%AE%E8%BD%AF%E9%BB%84%E9%87%91%E7%82%B9%E7%A8%8B%E5%BA%8F%E5%B7%A5%E5%85%B7/OnlineGame/BotDemoInCSharp/BotDemo/GoldenNumberService.cs): `实践项目/2019_MSC_黄金点/微软黄金点程序工具/OnlineGame/BotDemoInCSharp/BotDemo/GoldenNumberService.cs`

### Other components

- **Learner**
- **Golden Number service**

## Connections

- Learner → Python foundations: studies (evidence: `README.md`)
- Learner → Neural networks: studies (evidence: `README.md`)
- Learner → Classic ML: studies (evidence: `README.md`)
- Learner → Reinforcement learning: studies (evidence: `README.md`)
- Learner → Vision applications: explores (evidence: `README.md`)
- Learner → Comic translation: explores (evidence: `README.md`)
- Learner → Text-to-speech: explores (evidence: `README.md`)
- Learner → QA chatbot: explores (evidence: `README.md`)
- Learner → Vision middleware: explores (evidence: `README.md`)
- Learner → Couplet generation: explores (evidence: `README.md`)
- Learner → Code search: explores (evidence: `README.md`)
- Learner → Golden Number: practices (evidence: `README.md`)
- Vision endpoint → Image processor: processes image (evidence: `实践案例/B06-搭建中间服务层/src/Controllers/VisionController.cs`)
- Service registration → Image processor: registers (evidence: `实践案例/B06-搭建中间服务层/src/Startup.cs`)
- Service registration → Vision endpoint: enables MVC (evidence: `实践案例/B06-搭建中间服务层/src/Startup.cs`)
- Couplet endpoint → Couplet model: generates couplet (evidence: `实践案例/B13-AI对联生成案例/src/service/app.py`)
- Online game bot → Game API client: calls API (evidence: `实践项目/2019_MSC_黄金点/微软黄金点程序工具/OnlineGame/BotDemoInCSharp/BotDemo/Program.cs`)
- Game API client → Golden Number service: requests game state (evidence: `实践项目/2019_MSC_黄金点/微软黄金点程序工具/OnlineGame/BotDemoInCSharp/BotDemo/GoldenNumberService.cs`)
