ai-agent-book

环境要求

• Python 3.11–3.13（第 8 章部分内置第三方组件需要 Python 3.12+）
• 推荐安装 uv（官方文档 https://docs.astral.sh/uv/getting-started/installation/），pip 仍受支持
• 运行会调用模型的实验，需要至少一个模型提供商的 API Key
• 浏览器、CUDA、FFmpeg、Ollama、Playwright 浏览器等系统依赖，需参考各实验自己的 README

安装与启动步骤

1. 1克隆仓库

   把书本正文与配套代码下载到本地，后续所有命令都在仓库根目录执行。

   git clone https://github.com/bojieli/ai-agent-book.git
   cd ai-agent-book

   复制

2. 2用 uv 装章节依赖

   推荐方式，使用仓库提交的 uv.lock 获得可复现环境；ch1 可换成 ch2~ch10。

   uv sync --locked --extra ch1

   复制

3. 3用 pip 装依赖

   没装 uv 时使用，从 pyproject.toml 重新解析依赖，不会使用锁文件。

   python -m pip install -e ".[ch1]"

   复制

4. 4配置模型凭据

   支持根目录配置的实验，可复制 .env.example 为 .env 并填入至少一个提供商 Key。

   cp .env.example .env

   复制

5. 5运行配套实验

   在仓库根目录执行某个实验的入口脚本，把路径换成你要跑的章节实验。

   uv run python chapter1/context/main.py

   复制

6. 6pip 方式运行

   使用 pip 安装时可直接用 python 执行同一实验脚本。

   python chapter1/context/main.py

   复制

关键配置

如何确认成功

安装过程无报错，且执行 uv run python chapter1/context/main.py（或 python chapter1/context/main.py）后能看到实验正常输出。

常见问题

注意事项

• `all` 是不含本地训练栈的 CPU 友好组合，并不代表覆盖每个实验，使用特殊 extra 时请合并到同一条命令。
• 有些实验要求在自身目录放 .env 或直接导出环境变量，不一定都用仓库根目录的 .env。
• 只是阅读书籍的话，推荐直接下载 PDF / EPUB 离线阅读，无需安装任何依赖。
• 注意书稿版本已由 1.4 升级为 2.0，章节编号有调整，建议下载最新版 PDF。