Hugging Face Agents Course：5 分钟搭好环境，免费学完 AI Agent 全链路
【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-course
装好之后，你能在本地跑通 Hugging Face Agents Course 的全部学习依赖：从 smolagents 写出第一个 AI Agent，到 LangGraph、LlamaIndex 双框架实战，最后在 GAIA 基准上拿到课程认证。
环境核对清单
开始前先对照这张表确认三件事，缺哪个补哪个：
| 依赖项 | 最低版本 | 确认方式 |
|---|---|---|
| Python | 3.11 | 终端执行python --version，输出Python 3.11.x及以上 |
| git | 任意新版 | 执行git --version，能打印版本号即可 |
| 基础 Python 语法 + LLM 初步概念 | 无版本要求 | 能读懂函数、类，知道 LLM 是什么 |
版本约束来源：quiz/pyproject.toml 中
requires-python = ">=3.11"，依赖声明也都在这个文件里。
最快安装步骤
第 1 步：克隆课程仓库
目标：把课程内容拉到本地。
操作：
git clone https://gitcode.com/GitHub_Trending/ag/agents-course成功标志：当前目录下生成agents-course/文件夹，打开后能看到units/（多语言课程正文）、quiz/（测验工具）等子目录。
第 2 步：创建并激活虚拟环境
目标：隔离依赖，不污染系统 Python。
操作：
cd agents-course && python -m venv agents-env && source agents-env/bin/activate成功标志：命令行提示符前出现(agents-env)。Windows PowerShell 用户改用agents-env\Scripts\Activate.ps1激活。
第 3 步：安装核心依赖
目标：装齐课程运行所需的 4 个基础包，版本号约束照抄 quiz/pyproject.toml，不要省略。
操作：
pip install "datasets>=3.2.0" "huggingface-hub>=0.27.1" "ipykernel>=6.29.5" "requests>=2.32.3"成功标志：输出末尾出现Successfully installed ...，无红色ERROR。
第 4 步：安装第一个实操框架 smolagents
目标：Unit 1 的动手环节要写第一个 Agent，smolagents 就是主力框架。
操作：
pip install "smolagents[all]"成功标志：同样以Successfully installed结尾；如果提示已满足版本要求（Requirement already satisfied），也算通过。
自检时刻
一条命令验证 4 个核心包都能导入：
python -c "import datasets, huggingface_hub, ipykernel, requests; print('Agents Course 依赖就绪')"期望输出：终端打印Agents Course 依赖就绪。判定标准：只有一行中文输出、无任何ModuleNotFoundError，即环境可用；如果报某个模块找不到，回到第 3 步重装。
排错速查
报错：pip install提示requires Python >=3.11原因：系统默认 Python 版本低于 3.11处理：升级到 3.11+，或指定高版本解释器重建虚拟环境：python3.11 -m venv agents-env
报错：source: command not found原因：在 Windows CMD 里用了 Linux/macOS 语法处理：改用 PowerShell 执行agents-env\Scripts\Activate.ps1，或在 Git Bash 中重跑激活命令
报错：依赖安装长时间卡住或超时原因：直连 PyPI 速度慢处理：临时换镜像源，如pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ "datasets>=3.2.0" "huggingface-hub>=0.27.1"
报错：ModuleNotFoundError: No module named 'smolagents'原因：激活了别的解释器，或第 4 步装到了系统环境处理：确认提示符带(agents-env)，用pip list | grep smolagents核对，缺了就在激活状态下重装
下一步，选你的路线
- 想拿认证：按单元顺序推进。从 units/en/unit0/introduction.mdx 开始注册账号、加入社区，再到 units/en/unit1/tutorial.mdx 写出第一个 Agent，最后挑战 units/en/unit4/ 的 GAIA 最终项目
- 想快速写 Agent：直接跳到 Unit 1 的 tutorial，用 smolagents 把"思考-行动-观察"循环跑通
- 想对比三大框架：Unit 2 里 smolagents、LlamaIndex、LangGraph 三节各讲适用场景，适合先横看一遍再选
- 想加餐：微调函数调用（bonus-unit1）、Agent 可观测性与评估（bonus-unit2）、宝可梦对战游戏 Agent（bonus-unit3）
社区与文档入口：仓库 README.md 附有官方课程页面和 Discord 社区链接，卡住时先搜历史帖子再去提问；完整章节顺序见 units/en/_toctree.yml。
收尾
现在就去终端跑一遍第 1 步的git clone，然后打开 Unit 0 的第一课注册账号——环境就绪后，你离第一个能自己行动的 Agent 只差一个教程的距离。
【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-course
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
