aa1143/NamiAgent

零基础入门 AI Agent 的基础教程。不只是教程，也是一个能在本地跑起来的 Agent：读写文件、执行命令、MCP、长期记忆，自带网页端看清每一步。从 100 行最小循环开始，一课加一个能力，最后拆解 Claude Code、Codex 等主流 Agent

Open original source ↗

From the publisher

README & documentation

Source preview

Read the project’s overview, installation instructions and usage examples. The original README is the source of truth.

零基础入门 AI Agent 的基础教程不只是教程，也是一个能在本地跑起来的 Agent，自带网页端，每一步都看得见 [](https://github.com/aa1143/NamiAgent/actions/workflows/test.yml) [](https://www.python.org/) [](LICENSE) [](LICENSE-docs) [](https://namiai.tech/agent/) [](https://github.com/aa1143/NamiAgent/stargazers) [](https://x.com/antiAIvo) 图文教程 · 快速开始 · 在线可视化 · 作者 𝕏 写 hello.py 并运行：写文件、跑命令前弹窗确认长期记忆：新会话里它还记得你是谁 Agent 没有什么神秘的，核心就是一个 while 循环：调模型、执行工具、把结果写回上下文，再调模型。它是教程：从 100 行的最小循环开始，一课加一个能力：工具、权限、上下文管理、Skills、MCP、子 Agent、计划、记忆。最后拆解 Claude Code、Codex 等主流 Agent 是怎么做的。内容是我自己一步步学习、动手实践后整理出来的。它也是一个能用的本地 Agent：在你指定的工作区里读写文件、执行命令、接入 MCP、记住你是谁；写文件、跑命令前都会先问你。python web/app.py 打开网页端，左边看它每一步怎么想、调了什么工具，右边看每次发给模型的完整上下文。 Agent 是怎么工作的：10 章逐格播放，看上下文每转一圈怎么变长、在哪里出问题，以及各种 Agent 技巧到底在上下文里做了什么。下面是其中第 3 章，配合第 1 课看效果最好：需要 Python 3.10+。跑测试（不需要 API Key）：页首的两张动图就是网页端的真实运行录屏。 macOS 也可以直接双击 web/start.command：自动建虚拟环境、装依赖、让你粘贴 API Key（直接回车就是演示模式），然后打开浏览器。Agent 的工作区默认是 /agent-workspace。然后打开 http://localhost:8765 ：网页端直接导入 lessons/lesson-11 的…

aa1143/NamiAgent on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-11-04T13:02:53.189Z

Inside the original README — Document outline

Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.

Links from the README

References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.

Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.

What this repository does

Repository facts

Owner: aa1143
Primary language: Python
Stars: 318
Forks: 33
Open issues + pull requests: 0
License: MIT
Archived: No
Default branch: main
Created: 2026-10-30T11:03:30.000Z
Last push: 2026-10-30T13:37:27.000Z

Topics and intended use

Owner-supplied topics: agent, ai-agent, chinese, claude-code, deepseek, from-scratch, llm, mcp, python, tutorial

Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.

Evaluate before installing

Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-11-04T12:18:51.791Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

public-apis/public-apis

EbookFoundation/free-programming-books

donnemartin/system-design-primer

vinta/awesome-python

practical-tutorials/project-based-learning

NousResearch/hermes-agent