# huggingface/agents-course architecture

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

- Interactive diagram: https://gitdiagram.com/huggingface/agents-course
- Repository: https://github.com/huggingface/agents-course

## Overview

This repository is primarily the Hugging Face Agents Course: learners progress from introductory concepts through agent frameworks and Agentic RAG to a final benchmark project, with bonus material alongside the core curriculum. Course material is organized by unit and translated into several language editions. The sampled runtime code additionally automates translation through a hosted inference client and publishes quiz-question datasets to the Hugging Face Hub. The curriculum connections are documented in the README; code edges reflect the sampled scripts, not an inspection of the unsampled lesson content.

Main entry points: [`README.md`](https://github.com/huggingface/agents-course/blob/main/README.md) (Agents course), [`scripts/translation.py`](https://github.com/huggingface/agents-course/blob/main/scripts/translation.py) (Translation runner), [`quiz/push_questions.py`](https://github.com/huggingface/agents-course/blob/main/quiz/push_questions.py) (Quiz publisher), [`scripts/vi.py`](https://github.com/huggingface/agents-course/blob/main/scripts/vi.py) (Vietnamese prompt)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Course curriculum"]
  node_course["Agents course<br/>[README.md]"]
  node_welcome["Welcome"]
  node_foundations["Agent foundations"]
  node_frameworks["Agent frameworks"]
  node_agentic_rag["Agentic RAG"]
  node_final_project["Final project"]
end

subgraph group_bonus["Bonus curriculum"]
  node_fine_tuning["Function-call tuning"]
  node_observability["Observability and evaluation"]
  node_game_agents["Game agents"]
end

subgraph group_localization["Localization"]
  node_translation_config["Vietnamese prompt<br/>[vi.py]"]
  node_translator["Translation runner<br/>[translation.py]"]
  node_english_lessons["English lessons"]
  node_translated_lessons["Language editions"]
end

subgraph group_quiz["Quiz publishing"]
  node_quiz_data["Quiz questions<br/>[unit_1.json]"]
  node_quiz_publisher["Quiz publisher<br/>[push_questions.py]"]
end

node_learner(("Learner"))
node_inference{{"Inference provider"}}
node_hub{{"Hugging Face Hub"}}

node_learner -->|"takes"| node_course
node_course -->|"starts with"| node_welcome
node_course -->|"teaches"| node_foundations
node_course -->|"teaches"| node_frameworks
node_course -->|"teaches"| node_agentic_rag
node_course -->|"culminates in"| node_final_project
node_course -->|"offers bonus"| node_fine_tuning
node_course -->|"offers bonus"| node_observability
node_course -->|"offers bonus"| node_game_agents
node_translation_config -->|"calls"| node_translator
node_translator -->|"reads"| node_english_lessons
node_translator -->|"writes"| node_translated_lessons
node_translator -->|"requests translation"| node_inference
node_quiz_publisher -->|"reads"| node_quiz_data
node_quiz_publisher -->|"publishes dataset"| node_hub

click node_course "https://github.com/huggingface/agents-course/blob/main/README.md"
click node_welcome "https://github.com/huggingface/agents-course/tree/main/units/en/unit0"
click node_foundations "https://github.com/huggingface/agents-course/tree/main/units/en/unit1"
click node_frameworks "https://github.com/huggingface/agents-course/tree/main/units/en/unit2"
click node_agentic_rag "https://github.com/huggingface/agents-course/tree/main/units/en/unit3"
click node_final_project "https://github.com/huggingface/agents-course/tree/main/units/en/unit4"
click node_fine_tuning "https://github.com/huggingface/agents-course/tree/main/units/en/bonus-unit1"
click node_observability "https://github.com/huggingface/agents-course/tree/main/units/en/bonus-unit2"
click node_game_agents "https://github.com/huggingface/agents-course/tree/main/units/en/bonus-unit3"
click node_translation_config "https://github.com/huggingface/agents-course/blob/main/scripts/vi.py"
click node_translator "https://github.com/huggingface/agents-course/blob/main/scripts/translation.py"
click node_english_lessons "https://github.com/huggingface/agents-course/tree/main/units/en"
click node_translated_lessons "https://github.com/huggingface/agents-course/tree/main/units"
click node_quiz_data "https://github.com/huggingface/agents-course/blob/main/quiz/data/unit_1.json"
click node_quiz_publisher "https://github.com/huggingface/agents-course/blob/main/quiz/push_questions.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_course,node_welcome,node_foundations,node_frameworks,node_agentic_rag,node_final_project toneBlue
class node_fine_tuning,node_observability,node_game_agents toneAmber
class node_translation_config,node_translator,node_english_lessons,node_translated_lessons toneMint
class node_quiz_data,node_quiz_publisher toneRose
class node_learner,node_inference,node_hub toneIndigo
```

## Components

### Course curriculum

- [Agents course](https://github.com/huggingface/agents-course/blob/main/README.md): `README.md`
- [Welcome](https://github.com/huggingface/agents-course/tree/main/units/en/unit0): `units/en/unit0`
- [Agent foundations](https://github.com/huggingface/agents-course/tree/main/units/en/unit1): `units/en/unit1`
- [Agent frameworks](https://github.com/huggingface/agents-course/tree/main/units/en/unit2): `units/en/unit2`
- [Agentic RAG](https://github.com/huggingface/agents-course/tree/main/units/en/unit3): `units/en/unit3`
- [Final project](https://github.com/huggingface/agents-course/tree/main/units/en/unit4): `units/en/unit4`

### Bonus curriculum

- [Function-call tuning](https://github.com/huggingface/agents-course/tree/main/units/en/bonus-unit1): `units/en/bonus-unit1`
- [Observability and evaluation](https://github.com/huggingface/agents-course/tree/main/units/en/bonus-unit2): `units/en/bonus-unit2`
- [Game agents](https://github.com/huggingface/agents-course/tree/main/units/en/bonus-unit3): `units/en/bonus-unit3`

### Localization

- [Vietnamese prompt](https://github.com/huggingface/agents-course/blob/main/scripts/vi.py): `scripts/vi.py`
- [Translation runner](https://github.com/huggingface/agents-course/blob/main/scripts/translation.py): `scripts/translation.py`
- [English lessons](https://github.com/huggingface/agents-course/tree/main/units/en): `units/en`
- [Language editions](https://github.com/huggingface/agents-course/tree/main/units): `units`

### Quiz publishing

- [Quiz questions](https://github.com/huggingface/agents-course/blob/main/quiz/data/unit_1.json): `quiz/data/unit_1.json`
- [Quiz publisher](https://github.com/huggingface/agents-course/blob/main/quiz/push_questions.py): `quiz/push_questions.py`

### Other components

- **Learner**
- **Inference provider**
- **Hugging Face Hub**

## Connections

- Learner → Agents course: takes (evidence: `README.md`)
- Agents course → Welcome: starts with (evidence: `README.md`)
- Agents course → Agent foundations: teaches (evidence: `README.md`)
- Agents course → Agent frameworks: teaches (evidence: `README.md`)
- Agents course → Agentic RAG: teaches (evidence: `README.md`)
- Agents course → Final project: culminates in (evidence: `README.md`)
- Agents course → Function-call tuning: offers bonus (evidence: `README.md`)
- Agents course → Observability and evaluation: offers bonus (evidence: `README.md`)
- Agents course → Game agents: offers bonus (evidence: `README.md`)
- Vietnamese prompt → Translation runner: calls (evidence: `scripts/vi.py`)
- Translation runner → English lessons: reads (evidence: `scripts/translation.py`)
- Translation runner → Language editions: writes (evidence: `scripts/translation.py`)
- Translation runner → Inference provider: requests translation (evidence: `scripts/translation.py`)
- Quiz publisher → Quiz questions: reads (evidence: `quiz/push_questions.py`)
- Quiz publisher → Hugging Face Hub: publishes dataset (evidence: `quiz/push_questions.py`)
