# The Hugging Face Agents Course
If you like the course, **don't hesitate to ⭐ star this repository**. This helps us to **make the course more visible 🤗**.
## Content
The course is divided into 5 units. These will take you from **the basics of agents to a final assignment with a benchmark**.
Sign up here (it's free) 👉 https://bit.ly/hf-learn-agents
You can access the course here 👉 https://hf.co/learn/agents-course
| Unit | Topic | Description |
|------|--------------------------------|-----------------------------------------------------------------------------|
| 0 | [Welcome to the Course](https://huggingface.co/learn/agents-course/en/unit0/introduction) | Welcome, guidelines, necessary tools, and course overview. |
| 1 | [Introduction to Agents](https://huggingface.co/learn/agents-course/en/unit1/introduction) | Definition of agents, LLMs, model family tree, and special tokens. |
| 1.5 | [(Bonus Unit 1) Fine-tuning an LLM for Function-calling](https://huggingface.co/learn/agents-course/bonus-unit1/introduction) | Learn to fine-tune an LLM for Function-Calling |
| 2 | [2_frameworks](units/en/unit2/README.md) | Overview of smolagents, LangChain, LangGraph, and LlamaIndex. |
| 2.5 | [(Bonus Unit 2) Observability and Evaluation](https://huggingface.co/learn/agents-course/bonus-unit2/introduction) | Learn how to trace and evaluate your agents.
| 3 | [3_use_cases](units/en/unit3/README.md) | SQL, code, retrieval, and on-device agents using various frameworks. |
| 4 | [4_final_assignment_with_benchmark](units/en/unit4/README.md) | Automated evaluation of agents and leaderboard with student results. |
## Prerequisites
- Basic knowledge of Python
- Basic knowledge of LLMs
## Contribution Guidelines
If you want to contribute to this course, you're welcome to do so. Feel free to open an issue or join the discussion in the [Discord](https://discord.gg/UrrTSsSyjb). For specific contributions, here are some guidelines:
### Small typo and grammar fixes
If you find a small typo or grammar mistake, please fix it yourself and submit a pull request. This is very helpful for students.
### New unit
If you want to add a new unit, **please create an issue in the repository, describe the unit, and why it should be added**. We will discuss it and if it's a good addition, we can collaborate on it.
### Work on existing units
We are actively working on the units and if you want to join us, we will need to find a place in the workflow. Here's an overview of where we are open to collaboration:
| Unit | Status | Contributions |
|------|--------------|------------------------------------------------------------------------|
| 0 | ✅ Complete | Bug fixes and improvements only |
| 1 | ✅ Complete | Bug fixes and improvements only |
| 2 | 🚧 In Progress | If you're a contributor to a framework, we're open to contributions and reviews |
| 3 | 🗓️ Planned | If you're experienced with agents, we're open to help with use cases |
| 4 | 🚧 In Progress | Work is underway, no need for help with integration |
If in doubt, join the discussion in the [Discord](https://discord.gg/UrrTSsSyjb).
## Citing the project
To cite this repository in publications:
```bibtex
@misc{agents-course,
author = {Burtenshaw, Ben and Thomas, Joffrey and Simonini, Thomas},
title = {The Hugging Face Agents Course},
year = {2025},
howpublished = {\url{https://github.com/huggingface/agents-course}},
note = {GitHub repository},
}
```