langchain-course

环境要求

• git（用于克隆仓库与切换分支）
• uv（README 中所有依赖安装与运行命令均基于 uv）
• Python 环境（课程使用 Python 语言）
• 能访问 GitHub 与各项目所需外部 API 的网络环境

安装与启动步骤

1. 1克隆课程仓库

   把课程仓库下载到本地并进入目录，后续所有命令都在该目录下执行。

   git clone https://github.com/emarco177/langchain-course
   cd langchain-course

   复制

2. 2切换到项目分支

   课程按难度分分支，先切到入门分支；其他分支如 project/code-interpreter 同理。

   git checkout project/hello-world

   复制

3. 3同步项目依赖

   uv sync 会按项目配置安装依赖，务必在仓库目录内执行。

   uv sync

   复制

4. 4运行示例程序

   运行该分支的主程序，看到正常输出且无报错即表示环境可用。

   uv run python main.py

   复制

5. 5查看学习进度

   每个 commit 对应一节课，用该命令查看演进过程，可 checkout 回看历史提交。

   git log --oneline

   复制

6. 6克隆外部项目

   Ice Breaker 等外部项目不在本仓库，需单独克隆并按该项目自身说明配置。

   git clone https://github.com/emarco177/ice_breaker
   cd ice_breaker

   复制

如何确认成功

在分支目录执行 uv run python main.py，程序正常输出结果且无报错，即说明依赖与环境配置成功。

常见问题

注意事项

• README 中安装与运行步骤针对分支式项目，均使用 uv 而非 pip。
• 外部项目（Ice Breaker、Medium Analyzer、Documentation Helper 等）需按各自仓库的说明单独安装配置。
• 课程依赖真实 API，README 未提供密钥等配置细节，需结合分支内代码与实际服务自行准备。