ai-agent-deep-dive
逐行拆解 Agent 源码，从会用到懂原理
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 5831
使用教程
环境要求
- Python 环境（README 未指定版本，建议 3.8 以上）
- Poetry 依赖管理工具
- git（用于克隆仓库）
- 可访问网络的终端环境
安装与启动步骤
-
1克隆项目仓库
把源码拉到本地，后续所有命令都在项目根目录执行。
git clone https://github.com/tvytlx/ai-agent-deep-dive.git cd ai-agent-deep-dive -
2安装项目依赖
项目用 Poetry 管理依赖，该命令会按 pyproject.toml 创建虚拟环境并安装全部依赖。
poetry install -
3运行最小 Agent
用 CLI 传入一句中文问候，观察教学型 Agent 主循环与 Fake LLM 的流式响应。
poetry run agt "你好" -
4查看 Skills 列表
指定 skills 目录并列出已发现的技能，了解 Skills 发现机制的实际表现。
poetry run agt --skills-dir ./skills --list-skills -
5阅读核心源码
对照 docs/ 教学文档，重点看 agent.py 与 cli.py，理解主循环、Fake LLM 接口与 CLI 骨架。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
skills-dir | 否 | CLI 参数，指定 Skills 技能发现目录，配合 --list-skills 使用。 | ./skills |
如何确认成功
执行 poetry run agt "你好" 后终端能返回流式测试响应文本，且无依赖报错，即为运行成功。
常见问题
Q：运行时提示找不到 agt 命令怎么办？
A：确认已在项目根目录执行 poetry install 完成安装，并使用 poetry run agt 方式调用，不要直接敲 agt。
Q：它接入了真实的 GPT 或 Claude 模型吗？
A：没有。当前是教学型最小实现，内置可替换的 Fake LLM，输入什么就流式返回测试响应，未连接真实远程模型 API。
Q：想换成真实模型需要改哪里？
A：只需替换 LLM 调用层即可，Agent 主体无需重写，可参考 src/agt/agent.py 中的 Fake LLM 接口。
Q：没有 Poetry 可以用 pip 吗？
A：README 只给出了 Poetry 的安装与运行方式，未提供 pip 命令，建议先安装 Poetry 再按文档操作。
注意事项
- 本项目以文档加代码形式组织，PDF 报告见仓库中的 ai-agent-deep-dive-v2.pdf 与 v2.1.pdf。
- 额外章节《Hermes Agent 源码深度解析》需通过作者知识星球获取。
- 教学项目刻意保持结构简单，不要把它当作生产级 Agent 框架使用。
核心亮点
- 直接深入源码层面，而非停留在 API 调用教程，能看清 Agent 循环、工具调度、记忆模块的真实实现
- 覆盖多个主流 Agent 框架并做横向对比，便于理解不同设计取舍，对技术选型有参考价值
- 配套可运行的最小示例，理论解读与代码验证结合，学习路径清晰
不足之处
- 内容以静态文档为主，缺少自动化测试或版本兼容性保障，上游框架更新后部分解读可能滞后
- 偏重阅读与分析，缺少从零手写 Agent 的渐进式练习，动手环节相对薄弱
适用场景
- 想从调用框架进阶到理解 Agent 内部机制的开发者自学
- 团队做 Agent 技术选型时对比不同框架架构设计
- 面试或技术分享前快速梳理 Agent 核心原理与源码细节
替代项目
langchain、AutoGPT
上一篇：lecture-to-notes
同类项目推荐
From-Zero-to-AGI
开源
从零起步，一张图走完 AGI 学习路线
从零走向AGI之路！！！旨在深入了解通用人工智能（AGI）的发展路径，从最基础的概念起，逐···
AI-Interview
开源
数字人开口面试，答完自动出逐题评分报告
开源的 AI 模拟面试系统：真人数字人面试官开口提问、按你的回答追问，报告逐题打分；另含···
generative-ai
开源
一份资源，系统搞定生成式 AI 学习、实战与面试
Comprehensive resources on Generative AI, including a detailed roadmap, projects, us···
cs329z-chinese
开源
斯坦福智能体课程中文笔记，19讲+4实践一站学
斯坦福 Stanford CS329Z Engineering AI Agents 中文教程：面向 Python 开发者的 AI 智能体···
data_science_blogs
开源
跟着博客代码学数据科学，从建模到部署一站搞定
A repository to keep track of all the code that I end up writing for my blog posts.
hermes-agent-orange-book
开源
中文实战手册，带你从零吃透 Hermes Agent
Hermes Agent 从入门到精通 · 橙皮书系列 · Nous Research 开源 AI Agent 框架实战指南
AIAnswerer-Android
开源
截个图，AI 秒出答案，学习解题快人一步
智能答题助手 - Android平台AI答题应用，通过截图识别和AI分析为各类题目提供答案解析
open-csai-wiki
开源
把CS/AI知识整理成体系，照着学就完事
:bookmark_tabs: 开放 CS/AI 知识库，包括「基础知识、数据结构与算法、软件开发、大模型」···
AI-Code-Tutorials
开源
双语实战教程，快速上手 Claude Code 和 Codex 完成真实项目
Bilingual AI coding tutorials for Claude Code and OpenAI Codex: setup, CLI, Codex wo···