$ cat ~/map/pi-bluebook.md
pi-bluebook (Pi 学习蓝皮书)
Free unofficial Chinese-language learning path that takes Pi beginners from first install to skills, extensions, and long-running workflows.
tutorials✓ Sep 13
Facts
- repository
- github.com/xiaomoBoy/pi-bluebook ↗
- GitHub Stars
- ★ 317
- Forks
- 19
- license
- MIT
- npm / mo
- —
- last push
- Oct 11, 2026
install
npm ci && npm run docs:dev (run the VitePress site locally from a clone)## TL;DR
An unofficial Chinese-language learning handbook for the Pi coding agent — 5 modules, 14 lessons, and 8 cases that take a beginner from installation to sessions, context, skills, extensions, and long-running workflows.
## Key points
- $Every lesson follows a scenario, concept, hands-on, acceptance structure and treats independent verification as the finish line — an agent's self-reported done does not count as done.
- $Covers the full beginner path: installation and login, the first verifiable task, files and sessions, context and compaction, skills, extensions and packages, subagents, and long-running workflows on a VPS; macOS is the primary path with a dedicated Windows Git Bash setup path.
- $Version-sensitive facts — versions, auth, models, commands — are marked with verification dates and anchored to the official docs at pi.dev/docs/latest and the official sources on GitHub.
- $The book includes a chapter on Pi author Mario Zechner tracing the libGDX, RoboVM, Pi, and Earendil timeline, plus a translations section holding eleven Earendil-authorized Chinese translations of Pi, harness, session-mechanism, code-quality, and company-vision articles.
- $Read online at pi.xiaomovps.com; source on GitHub, with a Traditional Chinese edition synced from the Simplified original.
## FAQ
Q Is this an official Pi tutorial?
No — it is an unofficial learning handbook. The translations section is Earendil-authorized, but the handbook itself is community-written and anchored to the official docs.
Q Do I need to install Pi to read it?
No — the site is a VitePress site that previews locally with npm ci and npm run docs:dev, with no Pi install, model account, or API key required.
## References
## Related entries
$ pi-book (pi 的设计艺术)
A free Chinese-language book dissecting the design decisions behind Pi's architecture.
$ I tried Pi after watching its founder explain why he quit Claude Code
A hands-on dev.to write-up of trying Pi after hearing its founder's case against Claude Code.
$ learn-pi-agent
A chapter-by-chapter rebuild of Pi's agent harness, from one LLM call to a working coding agent.
## Guides
Last updated: Sep 13, 2026