agents-from-scratch

环境要求

• Python 环境（需可执行 pip 与 python）
• 本地可运行 LLM 的机器（项目全程使用本地模型，不调用云 API）
• 下载好的 GGUF 格式模型文件，放入 models/ 目录
• 无需任何 Agent 框架、云服务或 API Key

安装与启动步骤

1. 1获取项目代码

   把仓库克隆到本地并进入项目根目录，后续所有命令都在该目录下执行。

   git clone https://github.com/pguso/agents-from-scratch.git
   cd agents-from-scratch

   复制

2. 2安装依赖

   按 README 的 Quick Start 安装 requirements.txt 中列出的 Python 依赖，建议先建虚拟环境。

   pip install -r requirements.txt

   复制

3. 3放置 GGUF 模型

   自行下载一个 GGUF 格式的本地模型，放到项目根目录下的 models/ 文件夹中；README 未指定具体模型。

4. 4查看详细安装文档

   README 说明更详细的安装步骤在 QUICKSTART.md 中，遇到问题可先查阅该文件。

5. 5运行完整示例

   complete_example.py 包含 12 节课的可执行代码示例，运行后可看到概念如何串起来。

   python complete_example.py

   复制

如何确认成功

终端能正常执行 python complete_example.py，并依次打印出模型对提示词的文本回复，无导入或模型加载报错。

常见问题

注意事项

• 项目定位是教学教程，强调无框架、无隐藏推理，遇到疑惑应直接打开源码文件查看。
• README 的 Quick Start 只有三步，更详细的安装说明在 QUICKSTART.md 中。
• 12 节课是在同一个持续演进的 agent 上迭代，建议按顺序学习。
• 模型文件需自行下载，体积较大，请预留磁盘空间和下载时间。