# Microsoft AI-For-Beginners Repository Structure: A Complete Guide to Lessons, Quizzes, and Examples

> Explore the Microsoft AI-For-Beginners repository structure. Learn how lessons, quizzes, and examples are organized for easy navigation and study.

- Repository: [Microsoft/AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners)
- Tags: architecture
- Published: 2026-08-24

---

**The Microsoft AI-For-Beginners repository organizes its 12-week curriculum into the `lessons/` directory, supplemented by a Vue-based quiz application in `etc/`, multilingual translations in `translations/`, and environment configuration files at the root.**

The Microsoft **AI-For-Beginners** repository is a comprehensive educational codebase designed to teach artificial intelligence fundamentals through hands-on coding. Understanding the **AI-For-Beginners repository structure** allows learners to efficiently navigate weekly modules, locate framework-specific notebooks, and launch interactive quizzes. The project follows a clear pedagogical layout separating instructional content from supporting tools and localization assets.

## Core Curriculum Organization in `lessons/`

The `lessons/` directory contains the full 12-week curriculum, with each subfolder representing a distinct topic or week. According to the [`AGENTS.md`](https://github.com/microsoft/AI-For-Beginners/blob/main/AGENTS.md) file, this directory uses a **"lesson → notebook → lab"** pattern where every module includes a **README** explaining concepts, **Jupyter notebooks** in PyTorch, TensorFlow, and Keras variants, optional lab instructions, and auxiliary data files.

The sequential structure includes:

- **`0-course-setup/`** – Environment preparation and dependency installation
- **`1-Intro/`** – Foundational AI concepts and history
- **`2-Symbolic/`** – Knowledge representation and expert systems
- **`3-NeuralNetworks/`** – Perceptrons, multi-layer networks, and framework comparisons
- **`4-ComputerVision/`** – OpenCV, CNNs, autoencoders, GANs, and object detection
- **`5-NLP/`** – Text embeddings, RNNs, transformers, and LLM prompting
- **`6-Other/`** – Genetic algorithms, reinforcement learning, and multi-agent systems
- **`7-Ethics/`** – Responsible AI principles and bias mitigation
- **`X-Extras/`** – Supplementary material including multi-modal networks and CLIP

## Interactive Learning Tools in `etc/`

The `etc/` directory houses utility applications that enhance the learning experience. The **`etc/quiz-app/`** folder contains a **Vue 2.x** single-page application that delivers interactive quizzes linked throughout the curriculum. This application includes a [`package.json`](https://github.com/microsoft/AI-For-Beginners/blob/main/package.json) manifest, Vue components, and translation assets for internationalization. Additionally, **`etc/quiz-src/`** stores supplementary quiz-related source files.

To run the quiz application locally:

```bash
cd etc/quiz-app
npm install
npm run serve

```

## Multi-Language Support via `translations/`

The `translations/` directory provides automated localization of the curriculum content. Each language maintains its own subfolder, such as `translations/zh-CN/` for Chinese (Simplified) or `translations/fr/` for French, containing translated markdown files and localized quiz assets. The repository uses GitHub Actions to synchronize these translations with the primary English content, as referenced in the main [`README.md`](https://github.com/microsoft/AI-For-Beginners/blob/main/README.md).

## Environment Configuration and Entry Points

Several root-level files support immediate productivity:

- **[`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml)** – Defines a **Conda environment** pinning TensorFlow 2.17, PyTorch, Keras 3.5, OpenCV, and other core dependencies
- **[`AGENTS.md`](https://github.com/microsoft/AI-For-Beginners/blob/main/AGENTS.md)** – Documents the repository architecture and file organization for contributors
- **[`index.html`](https://github.com/microsoft/AI-For-Beginners/blob/main/index.html)** – Serves as the Docsify entry point for the documentation site hosted at https://microsoft.github.io/AI-For-Beginners/
- **`examples/`** – Contains ready-to-run scripts including "Hello AI World", simple neural networks, and image classifiers for absolute beginners

## Programmatically Exploring the Repository

Learners can interact with the curriculum structure using Python to discover content or load notebooks directly:

```python
import pathlib

# List all lesson directories programmatically

lessons = pathlib.Path("lessons").iterdir()
print([p.name for p in lessons if p.is_dir()])

```

To inspect a specific notebook, such as the Perceptron lesson in `lessons/3-NeuralNetworks/03-Perceptron/Perceptron.ipynb`:

```python
import nbformat
nb_path = pathlib.Path("lessons/3-NeuralNetworks/03-Perceptron/Perceptron.ipynb")
nb = nbformat.read(str(nb_path), as_version=4)
print(nb.cells[0].source)  # Display first cell content

```

## Summary

- The **AI-For-Beginners** repository separates content into `lessons/` (curriculum), `etc/` (tools), and `translations/` (localization)
- Each lesson folder contains framework-agnostic **Jupyter notebooks** supporting PyTorch, TensorFlow, and Keras
- The **Vue 2.x** quiz application in `etc/quiz-app/` provides interactive assessment capabilities
- Root-level files like [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml) and [`AGENTS.md`](https://github.com/microsoft/AI-For-Beginners/blob/main/AGENTS.md) provide immediate environment setup and architectural documentation

## Frequently Asked Questions

### What AI frameworks are supported in the AI-For-Beginners lessons?

According to the [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml) and lesson structure, the repository supports **TensorFlow 2.17**, **PyTorch**, and **Keras 3.5**. Most lessons include separate Jupyter notebooks for each framework, allowing learners to choose their preferred environment while studying identical concepts.

### How do I run the quiz application on my local machine?

Navigate to the **`etc/quiz-app/`** directory and execute `npm install` followed by `npm run serve`. This starts the Vue 2.x development server, enabling you to interact with the curriculum quizzes locally before deploying to production.

### Is the curriculum available in languages other than English?

Yes, the **`translations/`** directory contains automated translations for multiple languages including Chinese (Simplified), French, and others. Each language folder mirrors the structure of the main `lessons/` directory with localized markdown content and quiz assets.

### Where can I find setup instructions for the coding environment?

The **`0-course-setup/`** folder within `lessons/` contains comprehensive environment setup instructions. Additionally, the root **[`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml)** file defines a Conda environment with all necessary AI libraries pinned to specific versions for reproducibility.