Tutorial bilingüe y recorrido por el código fuente del SDK Pi-Agent, con código complementario y una skill para asistentes de IA que crean agentes.
hahhforest/pi-textbook
Libro de texto en chino que enseña a crear paso a paso un agente de programación al estilo Pi, con 15 checkpoints ejecutables en TypeScript.
- Estrellas
- 1,407
- Forks
- 83
- Issues abiertos
- 1
- Último commit
- hace 3 meses
¿Qué es?
Este curso enseña a crear desde cero un agente de programación al estilo Pi en TypeScript. Parte de una trayectoria de agente sin conexión y añade una capa en cada checkpoint: protocolos de mensajes y modelos, streaming, adaptadores de proveedores, herramientas, el ciclo del agente, árboles de sesiones, compactación del contexto, extensiones y un sistema de evaluación independiente.
Cada capítulo combina contenido didáctico, un commit real en el repositorio complementario del curso, pruebas específicas y experimentos de inyección de fallos. El código del curso es un historial de Git que se puede descargar, ejecutar y verificar en cada paso; no es pseudocódigo. El proyecto está disponible como libro en línea y como servidor local de desarrollo creado con npm.
El curso no es oficial y está escrito por la comunidad. El código se distribuye bajo la licencia MIT y el contenido del libro, bajo CC BY 4.0. También incluye un CLI auxiliar que configura los checkpoints y los directorios de práctica para usarlos con un agente de aprendizaje.
Funciones clave
- 01Quince checkpoints, cada uno correspondiente a un commit real que se puede descargar y ejecutar.
- 02Abarca todo el proceso, desde los tipos de mensajes y el streaming hasta los adaptadores de proveedores, las herramientas y el ciclo del agente.
- 03Incluye persistencia de árboles de sesiones y compactación del contexto para conversaciones largas.
- 04Concluye con un sistema de extensiones y una evaluación independiente del agente terminado.
- 05Incluye un CLI para saltar a un checkpoint o generar un directorio de ejercicios sin respuestas.
Casos de uso
- Aprender cómo funciona internamente un agente de programación construyendo uno por cuenta propia.
- Estudiar patrones de TypeScript, como las uniones discriminadas, los flujos de eventos y la validación en tiempo de ejecución, en un proyecto realista.
- Usar los checkpoints como itinerario de práctica guiada junto con un agente tutor de IA.
Inicio rápido
- 1
Clona el repositorio del libro de texto
git clone https://github.com/hahhforest/pi-textbook.git - 2
Entra en el directorio del proyecto
cd pi-textbook - 3
Instala las dependencias
npm install - 4
Inicia el servidor de desarrollo local
npm run dev
Antes de usarlo
- El libro de texto está escrito en chino, por lo que a los lectores de inglés les puede resultar difícil seguir el contenido principal.
- El código del curso está en una rama fork independiente, así que debes clonar esa rama para ejecutar los puntos de control.
Temas
Preguntas frecuentes
- ¿Qué es pi-textbook?
- Libro de texto en chino que enseña a crear paso a paso un agente de programación al estilo Pi, con 15 checkpoints ejecutables en TypeScript. Este curso enseña a crear desde cero un agente de programación al estilo Pi en TypeScript. Parte de una trayectoria de agente sin conexión y añade una capa en cada checkpoint: protocolos de mensajes y modelos, streaming, adaptadores de proveedores, herramientas, el ciclo del agente, árboles de sesiones, compactación del contexto, extensiones y un sistema de evaluación independiente.
- ¿pi-textbook es gratuito? ¿Qué licencia tiene?
- pi-textbook es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿pi-textbook sigue mantenido?
- Actualizado en los últimos 6 meses. El último commit de pi-textbook fue el 23 jul 2026.
- ¿Para qué puedo usar pi-textbook?
- Aprender cómo funciona internamente un agente de programación construyendo uno por cuenta propia. Estudiar patrones de TypeScript, como las uniones discriminadas, los flujos de eventos y la validación en tiempo de ejecución, en un proyecto realista. Usar los checkpoints como itinerario de práctica guiada junto con un agente tutor de IA.
- ¿Cómo se instala pi-textbook?
- Clona el repositorio del libro de texto: git clone https://github.com/hahhforest/pi-textbook.git Entra en el directorio del proyecto: cd pi-textbook Instala las dependencias: npm install Inicia el servidor de desarrollo local: npm run dev
- ¿Dónde consigo pi-textbook?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/hahhforest/pi-textbook
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Tutorial de Python de 17 lecciones para crear desde cero un entorno de agente similar a Claude Code, empezando con un único bucle y bash.
Taller paso a paso en Go para crear un agente de programación con la API de Claude, añadiendo herramientas de archivos, shell y búsqueda una por una.
Manual comunitario no oficial en chino para el entorno de terminal Pi Coding Agent, desde la instalación hasta Skills, Extensions, Subagents y flujos de trabajo prolongados.
Agente de programación autónomo y de código abierto, disponible como extensión para IDE, CLI de terminal, aplicación de escritorio o SDK.
Agente de programación para terminal con LSP, depurador, navegador y herramientas para subagentes integrados, compatible con más de 60 proveedores de modelos.