aa1143/NamiAgent

这是什么？

核心功能

• 0111 课逐步构建 Agent，每课都是可运行的代码快照
• 02支持工具调用、权限确认、上下文管理和会话持久化
• 03提供基于 stdio 的 MCP 客户端，以及独立上下文的子 Agent
• 04网页端逐步展示每次模型调用、工具调用和完整上下文
• 05兼容任意 OpenAI 格式接口，默认使用 DeepSeek，仅依赖 openai 包
• 06第 3 课起的测试使用假模型运行，无需 API Key

适用场景

• 从底层理解 Agent 循环、工具调用和上下文管理的工作方式
• 对照相邻课程的代码，比较每个阶段的差异
• 在专用工作区中运行一个带确认提示的本地小型 Agent
• 通过配套的拆解文章了解主流编码 Agent 的结构

快速上手

1. 1

   克隆仓库

   git clone https://github.com/aa1143/NamiAgent.git
2. 2

   进入项目并安装依赖

   cd NamiAgent && pip install -r requirements.txt
3. 3

   设置模型 API 密钥并创建工作区

   export API_KEY=你的模型密钥 && export NAMI_WORKSPACE=~/agent-workspace && mkdir -p $NAMI_WORKSPACE
4. 4

   运行第 5 课的 Agent

   cd lessons/lesson-05 && python agent.py

使用前须知

• !需要模型 API 密钥，默认使用 DeepSeek。
• !Agent 会执行命令并读写文件，应在专门的工作区目录中运行。
• !这是教学项目，不是生产级 Agent 框架。
• !docs/ 下的文章采用 CC BY-NC 4.0 许可，禁止商用。

收录于专题

标签

常见问题

NamiAgent 是什么？

一套从零手写 AI Agent 的中文教程，附带可在本地运行并带网页端的 Agent。 NamiAgent 是一套面向零基础读者的 AI Agent 教程，同时附带一个可在本地运行的小型 Agent。核心思路是一个 while 循环：调用模型、执行工具、把结果写回上下文，再次调用模型。课程从约 100 行的最小循环开始，每课增加一项能力，包括工具、权限、上下文管理、Skills、MCP、子 Agent、计划和长期记忆，最后拆解 Claude Code、Codex 等主流 Agent 的实现思路。

NamiAgent 可以免费使用吗？用的什么许可证？

NamiAgent 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

NamiAgent 还在维护吗？

活跃维护中。NamiAgent 最近一次提交是在 2026年10月30日。

NamiAgent 适合用来做什么？

从底层理解 Agent 循环、工具调用和上下文管理的工作方式 对照相邻课程的代码，比较每个阶段的差异 在专用工作区中运行一个带确认提示的本地小型 Agent 通过配套的拆解文章了解主流编码 Agent 的结构

NamiAgent 怎么安装和运行？

克隆仓库: git clone https://github.com/aa1143/NamiAgent.git 进入项目并安装依赖: cd NamiAgent && pip install -r requirements.txt 设置模型 API 密钥并创建工作区: export API_KEY=你的模型密钥 && export NAMI_WORKSPACE=~/agent-workspace && mkdir -p $NAMI_WORKSPACE 运行第 5 课的 Agent: cd lessons/lesson-05 && python agent.py

在哪里获取 NamiAgent？

源代码和安装说明在 GitHub 上：https://github.com/aa1143/NamiAgent