从零跑通第一个AI智能体：Hugging Face Agents Course 免费实战指南-创锋一号

从零跑通第一个AI智能体：Hugging Face Agents Course 免费实战指南

【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-course

想自己写 Agent，却卡在"从哪开始"上？Hugging Face Agents Course 是一门免费开源的 AI智能体课程：从 Agent 基础概念一路讲到通过公开基准评测的最终项目。你只要有 Python 基础，学完就能跑通一个完整的 AI Agent，还能把作品提交到排行榜。这篇指南帮你用 5 分钟从 clone 装到能跑。

⏱ 5分钟快速上手：Agent课程最小安装路径

跑起来只需要两件事：拉仓库、装核心依赖。

git clone https://gitcode.com/GitHub_Trending/ag/agents-course cd agents-course

这条命令把全部课程内容拉到本地，各单元的讲义和 quiz/ 里的练习题都在里面。

pip install datasets huggingface-hub ipykernel requests

这几个包覆盖课程需要的数据加载、模型访问和 Notebook 内核，是跑通课程的最短依赖集。

怎么确认装好了？在终端跑一句导入测试：

python -c "import datasets, huggingface_hub, ipykernel"

没有任何报错输出，环境就算就绪了。

开跑前自检清单

装之前花 30 秒对一遍，能省掉后面的排查时间：

检查项	要求	自查方式
Python 版本	3.11 及以上	`python --version`
编程基础	熟悉 Python 基本语法	能独立写循环和函数
LLM 认知	知道 token、上下文是什么	看过任意一篇入门科普
网络	能访问 PyPI 和模型服务	正常 pip 装包无超时

Python 版本不达标就先升级，其余依赖都依赖它。

课程地图：从会写Prompt到能交付完整项目

这门课不按知识点堆，而是按能力递进交付，一条线看下来就很清楚：

Unit 0熟悉工具、摸清课程玩法，属于热身区
Unit 1掌握"思考—行动—观察"循环，用 smolagents 写出你的第一个 Agent，通关拿第一张证书
Unit 2三大框架 smolagents、LlamaIndex、LangGraph 任选深挖，建议从 smolagents 入门，代码量最小
Unit 3实战 Agentic RAG：给 Agent 挂上检索工具，让它回答真实问题
Unit 4把自研 Agent 提交 GAIA 基准、上排行榜，换优秀证书

另外还有 3 个 Bonus 单元：Function-calling 微调、Agent 可观测性、宝可梦对战 Agent，学有余力再回来看。内容也提供多语言版本，中文读者可以直接看 units/zh-CN/。

进阶配置：本地模型与开发工具链（可选）

装完就完事了？还没完。默认路径是调云端 API，不想依赖云端的话，先装 Ollama 再拉一个本地模型：

ollama pull qwen2:7b

这样推理全程在本地完成，不花 token 也不受网络波动影响。

学习环境两条支线，选顺手的：

Jupyter：ipykernel 已装好，注册内核后逐格跑各课 notebook，边看边试
VS Code：直接打开仓库，终端里跑课程示例脚本，改代码更顺手

至于 LangGraph、LlamaIndex 这类进阶框架，学到哪个单元再装哪个，一句 pip 的事，别提前全装。

踩坑速查：高频问题30秒自救

症状	处方
pip 报依赖冲突	切虚拟环境隔离：`python -m venv agents-env && source agents-env/bin/activate`
下载包慢或超时	换国内镜像：`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ 包名`
Notebook 内核找不到	重装内核：`pip install ipykernel && python -m ipykernel install --user`
本地模型跑不动	换更小参数量的模型，或先退回云端 API 学完概念

下一步：学习路线与社区入口

每个单元留 1～2 小时，至少跑通一个动手实验，别把课程当小说读
Unit 1 最重，慢慢过；小测验全过就能领第一张证书
单元细节和目录结构看 units/en/

社区入口在 Discord，Unit 0 里就有引导，卡住就去提问，比闷头查资料快。

现在，把 Unit 0 的 notebook 跑起来吧，剩下的交给你。

【免费下载链接】agents-courseThis repository contains the Hugging Face Agents Course.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-course

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析