{"id":47338217,"url":"https://github.com/alienzhou/zero2agent","last_synced_at":"2026-03-17T22:19:52.675Z","repository":{"id":343756275,"uuid":"1177406451","full_name":"alienzhou/zero2agent","owner":"alienzhou","description":"A hands-on course on building an AI agent from scratch — code included, with a full step-by-step build log, based on real product experience.","archived":false,"fork":false,"pushed_at":"2026-03-11T16:24:10.000Z","size":494,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-11T21:52:24.409Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alienzhou.png","metadata":{"files":{"readme":"README.en.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-10T01:58:49.000Z","updated_at":"2026-03-11T16:24:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alienzhou/zero2agent","commit_stats":null,"previous_names":["alienzhou/zero2agent"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/alienzhou/zero2agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fzero2agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fzero2agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fzero2agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fzero2agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alienzhou","download_url":"https://codeload.github.com/alienzhou/zero2agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alienzhou%2Fzero2agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30633244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-17T22:19:52.154Z","updated_at":"2026-03-17T22:19:52.660Z","avatar_url":"https://github.com/alienzhou.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/zero2agent-banner.png\" alt=\"Zero2Agent Banner\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eZero2Agent\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/alienzhou/zero2agent\"\u003e\u003cimg src=\"https://img.shields.io/badge/language-TypeScript-blue\" alt=\"Language\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/alienzhou/zero2agent/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/alienzhou/zero2agent\"\u003e\u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen\" alt=\"PRs Welcome\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"./README.md\"\u003e中文\u003c/a\u003e | \u003ca href=\"./README.en.md\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e🚀 A Hands-on Course for Building Production-Grade AI Agents from Scratch\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ci\u003eDive into engineering details, build your first Coding Agent\u003c/i\u003e\n\u003c/p\u003e\n\n---\n\n## 🎯 About\n\n\u003e There's plenty of Agent-related content out there—papers, tutorials, products, open-source projects—but few teach you how to \"build a production-grade Agent from scratch.\" This repository is such a **teaching case project**.\n\n- **Starting from the first line of code**, step by step building a production-grade Coding Agent similar to Claude Code / Codex\n- **Completely open and transparent**, including requirements analysis, design decisions, pitfalls, and detours\n- **Recording the real process of collaborating with AI**, Vibe Coding / Agentic Engineering will be applied throughout development\n\n---\n\n## ✨ How Is This Different?\n\n| Dimension              | Other Courses                          | Open-Source Products                  | Zero2Agent                                                            |\n| ---------------------- | -------------------------------------- | ------------------------------------- | --------------------------------------------------------------------- |\n| **Engineering Practice** | Concept-focused, demo-level code       | Only final code, no process           | Deep dive into real engineering problems, distilled from actual Agent development experience |\n| **Production-Grade**   | Basic features and cases               | Complete but complex, hard to learn   | Features curated from real products, designed as hands-on material    |\n| **Step-by-Step**       | Chapter-based, large gaps, not detailed | Code changes too complex to follow    | Each iteration can be followed independently, right-sized, progressive |\n\n---\n\n## 🎓 Is This for You?\n\nIf you:\n\n- 🌱 **Want to get started with LLM application development**, but don't know where to begin\n- 🤖 **Want to learn AI Agent development**, but find blog posts too abstract and frameworks too black-box\n- 🛠️ **Want to see what real AI-assisted development looks like**, not the \"done in 10 minutes\" marketing stories\n- 📚 **Prefer learning by doing**, rather than just reading theory\n\nThen this teaching project is for you.\n\n---\n\n## 📦 What You'll Get\n\n### 📖 See the Complete/Real AI Agent Building Process\n\nContent distilled from production projects as teaching cases, not purely a Toy Project, but based on real development:\n\n- Starting from actual problems/requirements\n- Including requirements discussion records (why we did this, not that), design documents (spec for each iteration)\n- Accompanying code implementation\n- Retrospective notes (what went right, what went wrong)\n\n### 🤖 Learn AI-Assisted Development\n\nThis project also uses AI-assisted development throughout, itself a journey of Vibe Coding/Agentic Engineering. You can see:\n\n- What actual coding conversations and prompts with AI look like\n- Practice of SSD development and other patterns\n- How to use AI to do more\n\n### 🔧 Pressure-Free Follow-Along Mode\n\nEvery iteration has a Git tag, you can:\n\n```bash\ngit checkout E01-S001-react-basic  # Jump to any iteration\n```\n\nFork it and get hands-on—that's the best way to learn. Don't worry, you can enter at **any time, from any progress point** (git tag) to follow along, or pick the topics that interest you.\n\n---\n\n## 🗺️ Course Roadmap\n\nThe course content is organized into four layers:\n\n- **README / Homepage**: quickly understand the project and where to start\n- **Roadmap Overview**: see the full learning map first\n- **Epic Page**: understand why a stage exists\n- **Story Page**: enter a concrete topic and learn how to read the implementation\n\n### Current Roadmap\n\n| Epic | Goal | Status |\n| ---- | ---- | ---- |\n| [Epic 1: Read / Search](./specs/E01-read-and-search/README.md) | Build a safe, explainable minimal read-only loop for the Agent | 🚧 In Progress |\n| Epic 2: Act / Modify / Execute | Move the Agent from \"can inspect\" to \"can take action\" | 📝 Planned |\n| Epic 3: Core Capabilities and Productization | Move the Agent from a demo toward a usable product shape | 📝 Planned |\n| Epic 4: Robustness and Context Management | Handle failures, long context, and complex runtime situations | 📝 Planned |\n| Epic 5: Extensibility | Add AGENTS, Skills, MCP, Hooks, and other extension capabilities | 📝 Planned |\n\n**Recommended starting points**:\n\n- Start with the [Course Roadmap Overview](./docs/roadmap/README.md)\n- Then go to [Epic 1: Read / Search](./specs/E01-read-and-search/README.md)\n- If you want to see a full Story example directly, start from [E1-S1: Bootstrapping the Minimal Read-Only Loop](./specs/E01-read-and-search/S001-react-basic/README.md)\n\n---\n\n## ⚠️ What This Is NOT\n\nThis is not an Agent product intended for direct production use, it's more of a \"teaching tool.\"\n\nIf you're looking for an out-of-the-box AI Agent, try Claude Code, Cursor, Codex, or projects like Open Code, PI.\n\nThis is a **learning resource**, not a pure tool.\n\n---\n\n## 📁 Project Structure\n\n```\nzero2agent/\n├── packages/           # Code\n│   ├── core/           # Agent core logic\n│   ├── tui/            # CLI interface\n│   └── shared/         # Shared code\n├── specs/              # Design documents\n├── retros/             # Retrospective notes\n├── .vibecoding/        # AI collaboration records\n├── .discuss/           # Requirements discussion records\n└── CHANGELOG.md        # Iteration log\n```\n\n---\n\n## 📈 Iteration Progress\n\n| Iteration | Content           | Status    |\n| --------- | ----------------- | --------- |\n| E01-S001  | Basic Agent Loop  | ✅ Done |\n\n👉 See full iteration details and learning guides:\n\n- [Course Roadmap](./docs/roadmap/README.md)\n- [CHANGELOG.md](./CHANGELOG.md)\n\n---\n\n## 🚀 Quick Start\n\n```bash\ngit clone git@github.com:alienzhou/zero2agent.git\ncd zero2agent\npnpm install \u0026\u0026 pnpm build\npnpm --filter @zero2agent/tui start\n```\n\nRequirements: Node.js \u003e= 22.0.0, pnpm \u003e= 9.0.0\n\n---\n\n## 📄 License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falienzhou%2Fzero2agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falienzhou%2Fzero2agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falienzhou%2Fzero2agent/lists"}