Repolode
hahhforest

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. 1

    Clona el repositorio del libro de texto

    git clone https://github.com/hahhforest/pi-textbook.git
  2. 2

    Entra en el directorio del proyecto

    cd pi-textbook
  3. 3

    Instala las dependencias

    npm install
  4. 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