Home / NamiAgent
aa1143/NamiAgent
零基础入门 AI Agent 的基础教程。不只是教程,也是一个能在本地跑起来的 Agent:读写文件、执行命令、MCP、长期记忆,自带网页端看清每一步。从 100 行最小循环开始,一课加一个能力,最后拆解 Claude Code、Codex 等主流 Agent
PythonCategories: Coding agentsMCP
Our summary
NamiAgent 是一个面向零基础读者的 AI Agent 教程,同时也是一个可在本地运行的最小 Agent。它从约 100 行的最小循环开始,逐课加入工具、权限、上下文管理、Skills、MCP、子 Agent、计划和记忆等能力,并附带一个可在浏览器中查看每一步的网页端。
Who it is for: 想从零理解 AI Agent 工作原理的中文学习者
What the README claims
- Agent 的核心是一个 while 循环:调用模型、执行工具、把结果写回上下文。
核心就是一个 while 循环:调模型、执行工具、把结果写回上下文,再调模型。
Not checked - 每课提供一个可运行的代码快照,共 lesson-01 到 lesson-11。
每个目录都是学完这一课时的完整代码,可以直接运行
Not checked - 第 11 课包含 49 个测试,使用假模型运行,不需要 API Key。
第 11 课共 49 个,用假模型跑,不需要 API Key
Not checked - 使用 OpenAI 兼容接口,默认使用 DeepSeek,更换模型只需修改两个环境变量。
使用 OpenAI 兼容接口,默认用 DeepSeek,换模型只需要改两个环境变量
Not checked
Written by AI from the project's README on 2026-11-04. It does not affect the verdict.
Watching: no other rule matched yet.
7-day star gain 62, down from 111 the week before.
Gaining 62 stars this week. Last push 23 days ago.
Verdict
TOO EARLY scored 1h ago
There is not enough data on this project yet to call it. The numbers below are shown anyway.
Too close to call Hype Gap between +0 and +42.
Early read: we are missing data on the size of the team behind it and how widely it is used. This is an estimate and will be replaced by a verdict once we have the data. How early reads work.
- Hype
- 61
- Reality
- 24
- Hype Gap
- +37
- Momentum
- -
- Confidence
- 60%
- Maintained moves Reality -11 points.
- Responsive moves Reality -10 points.
Rule verdict-2.0, scoring score-2.0. How we score. Backtest.
Repository on GitHub Project homepage
Maintained by
Maintained by 1 primary developer, 0 external contributors in the last 90 days.
- aa1143 is a GitHub individual account.
- GitHub account created August 2013.
- Top contributors by commits: aa1143 100%.
Why now 11% of its stars arrived in the last 7 days. No Hacker News posts in the last 7 days.
- Stars StarsThe number of GitHub stars on the repository at our latest reading.
- 588
- Gain 7d Gain 7dStars gained since our latest reading from at least 7 days ago.
- +62
- Pace Velocity (Nx usual pace)This week's star gain divided by the project's usual weekly gain. The usual gain is the average weekly gain over the 4 weeks before (days 8 to 35 ago), counted as at least 10 stars. 2.0x means twice the usual pace. Without a reading from 35 days ago, the ranking assumes 2% of the stars the project had 7 days ago as its usual weekly gain. More on the methodology page
- 5.9x
- HN points HN pointsHacker News points added up across posts that mention the project, published in the last 7 days.
- 0 7 days
- Downloads DownloadsDownloads per day of the project's package, as the registry (npm or PyPI) reports them.
- n/a
- Contributors Contributors, all timePeople and anonymous contributors who have ever committed to the repository, as GitHub counts them. A small number is context, not a flaw: many solid projects are kept by one or two people.
- 1
- Last release Latest releaseDays since the latest GitHub release was published.
- n/a
Gain 24h Gain 24hStars gained since our latest reading from at least 24 hours ago. +6. Forks ForksThe number of GitHub forks of the repository at our latest reading. 62. Open issues Open issuesThe number of open issues on the repository at our latest reading, as GitHub counts them. 1. Days since push Days since pushDays since the last push to the repository. 23 days. Archived ArchivedWhether the owner has archived the repository on GitHub. An archived repository is read-only. no. Hacker News posts in 7 days Hacker News postsThe number of Hacker News posts that mention the project, published in the last 7 days.: 0. Watchers WatchersThe number of GitHub users watching the repository for notifications, at our latest reading. 5.
Facts
Nerd stuff
- Docs
- docs/ folder (detected)
- License
- MIT (detected)
The Receipts
We have stored no threads, mentions, package numbers or dependency facts for this project yet.
What changed recently
GitHub release dates we stored. We do not track license changes yet.
Cite this
NamiAgent is a GitHub project at https://github.com/aa1143/NamiAgent written mainly in Python, described there as "零基础入门 AI Agent 的基础教程。不只是教程,也是一个能在本地跑起来的 Agent:读写文件、执行命令、MCP、长期记忆,自带网页端看清每一步。从 100 行最小循环开始,一课加一个能力,最后拆解 Claude Code、Codex 等主流 Agent".
Source: https://midorreal.com/project/aa1143-namiagent, checked 22 November 2026. The same facts as JSON: /project/aa1143-namiagent.json.
Rank history
Peak day: +53 stars on 4 Nov 2026, 18 days ago.
Best rank on Blowing up: #67 on 11 Nov 2026.
Stars
Packages
- We checked npm, PyPI, Docker Hub, crates.io and Homebrew and found no package that links to this repository.
Signals
| Source | What we measured | Checked |
|---|---|---|
| GitHub | 588 stars, 62 gained in 7 days | 22 Nov 2026 |
| Hacker News | No posts stored | - |
| Feed mentions | Not tracked yet | - |
| npm | No linked package found | - |
| PyPI | No linked package found | - |
| Docker Hub | No linked package found | - |
| crates.io | No linked package found | - |
| Homebrew | No linked package found | - |
| deps.dev | Not tracked yet | - |
| Hugging Face | Not tracked yet | - |
| Bluesky | Not tracked yet | - |
| Stack Exchange | Not tracked yet | - |
| YouTube | Not tracked yet | - |
Attention vs adoption
Attention: above 89% of tracked projects
Star velocity against all tracked projects
Adoption: not enough data to rank
Downloads, dependents and pulls
Not enough comparable data yet to set attention against adoption. This describes the numbers; it is not a verdict.
Compared with Coding agents
| Measure | This project | Category median |
|---|---|---|
| Star velocity | 5.9 | 0.4 |
| Days since release | no data | 4.5 |
| Contributors, all time | 1 | 2 |
| Median time to first reply on issues | no data | 14 hours |
| Commits in the last 30 days | 20 | 48 |
Star velocity: above 88% of Coding agents projects
Contributors, all time: above 0% of Coding agents projects
Commits in the last 30 days: above 35% of Coding agents projects
Compared with the project's first category only. A percentile line appears only where at least 30 projects in the category have the measure. This describes the numbers; it is not a verdict.
Compare with
Hacker News
| Post | Points PointsThe points the post has on Hacker News. | Comments CommentsThe number of comments on the post on Hacker News. | Date |
|---|---|---|---|
| No Hacker News posts mention it in the last 7 days. | |||
Caveats
Repo health
- Languages LanguagesShare of the repository's code by bytes, as GitHub's language detection reports it. The five biggest languages are named and the rest are grouped as Other.Python 95%, HTML 5%
- License LicenseThe SPDX license id GitHub detects, and a class: Open source (OSI) if the license is on the Open Source Initiative approved list, Source-available if the code is readable but the license limits use, Unclear if GitHub cannot match a known license, No license detected if it finds none. A public repository without a license is not open source.MIT, Open source (OSI)
- Repository age Repository ageTime since the repository was created on GitHub. This is the repository, not necessarily the project, which may have existed elsewhere before.22 days, created 30 Oct 2026
Development
- Commits in the last 7 days Commits in the last 7 daysCommits to the repository in the last 7 days, as GitHub counts them.0
- Commits in the last 30 days Commits in the last 30 daysCommits to the repository in the last 30 days, as GitHub counts them.20
- Commits in the last 90 days Commits in the last 90 daysCommits to the repository in the last 90 days, as GitHub counts them.20
- Contributors, all time Contributors, all timePeople and anonymous contributors who have ever committed to the repository, as GitHub counts them. A small number is context, not a flaw: many solid projects are kept by one or two people.1, a small team
- Releases ReleasesThe number of GitHub releases, and how many days ago the latest one was published.0
- Issues in the last 30 days Issues in the last 30 daysIssues opened and issues closed in the last 30 days, as GitHub search counts them.0 opened, 0 closed
- Pull requests merged in the last 30 days Pull requests merged in the last 30 daysPull requests merged in the last 30 days, as GitHub search counts them.0
Maintenance
- Stale open issues Stale open issuesOpen issues with no update in the last 90 days, as GitHub search counts them.0
- Open pull requests Open pull requestsPull requests open now, as GitHub search counts them.1
Hygiene
- Automated tests or builds (CI) Automated tests or builds (CI)Whether the repository has at least one GitHub Actions workflow file in .github/workflows.Yes
- A tests folder A tests folderWhether the repository has a top-level folder named tests, test, __tests__ or spec.No
- A license A licenseWhether GitHub detects a license file in the repository.Yes
- Contributing guide Contributing guideWhether the repository has a contributing guide.No
- Code of conduct Code of conductWhether GitHub finds a code of conduct in the repository.No
- CODEOWNERS file CODEOWNERS fileWhether the repository has a CODEOWNERS file, which names who reviews changes to which files.No
- A Dockerfile A DockerfileWhether the repository has a Dockerfile at its top level.No
Security
- Security policy Security policyWhether the repository has a SECURITY.md or SECURITY.rst file.No
- Unpatched high or critical advisories Unpatched high or critical advisoriesPublished GitHub security advisories rated high or critical on this repository that list a vulnerable version with no patched version.0
Badge
For maintainers: one measured fact, no verdict.
Markdown
[](https://midorreal.com/project/aa1143-namiagent)
HTML
<a href="https://midorreal.com/project/aa1143-namiagent"><img src="https://midorreal.com/badge/aa1143-namiagent.svg" alt="Mid or Real"></a>
Verdict badge: It shows the verdict as this page shows it today.
Markdown
[](https://midorreal.com/project/aa1143-namiagent)
HTML
<a href="https://midorreal.com/project/aa1143-namiagent"><img src="https://midorreal.com/badge/aa1143-namiagent.svg?style=verdict" alt="Mid or Real: too early"></a>
Passport
Copy these facts into a post, a README or a page. Cite as "Source: Mid or Real". Full record: JSON.
First tracked 3 Nov 2026 at 265 stars.
- GitHub data 72 min old
- Hacker News data 1 min old, no posts found
Is this your project? Claim it
Figures by method 1.0