hahhforest/pi-textbook resource

Health v2 · maintenance only

Flags: no_releases young

Adoption not part of the score

1267 stars · 76 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

An open-source Chinese-language textbook ('动手学 Pi' / Build Your Own Pi) that teaches agent engineering by building a Pi-style coding agent in TypeScript across 15 runnable checkpoints. Each chapter pairs textbook prose with real commits, focused tests, and fault-injection experiments along a single evolving codebase.

Use cases

• learn how to build an LLM coding agent from scratch
• understand agent loop and tool calling internals
• study streaming model provider integration in TypeScript
• learn session persistence and context compaction for agents
• hands-on tutorial for building AI agents with real commits and tests
• learn TypeScript event streaming and protocol design
• understand how coding agents execute file and bash tools

When to choose

• you want a structured, test-verified path to understanding agent internals rather than a finished product
• you prefer learning by rebuilding a system incrementally with real git history
• you read Chinese (or English) and want a D2L-style short feedback loop for agent engineering

When to avoid

• you need a production-ready agent framework to use directly rather than a teaching codebase
• you want a quick reference or source-code tour instead of a multi-week course
• you need agent features beyond the teaching scope, such as built-in permission confirmation or cwd jail

Facets

learning-resource · maturity active

agent-framework llm-inference developer-tools testing large-language-models tutorials education developer-tools cli build-your-own agent-engineering chinese-language textbook checkpoints hands-on-learning coding-agent ai-agents typescript nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="hahhforest/pi-textbook")