Repolode
hahhforest

hahhforest/pi-textbook

Livro didático em chinês que ensina a criar, passo a passo, um agente de programação no estilo Pi em TypeScript, com 15 checkpoints executáveis do Git.

Estrelas
1,407
Forks
83
Issues abertas
1
Último commit
há 3 meses

O que é?

Este curso ensina a criar do zero, em TypeScript, um agente de programação no estilo Pi. Ele parte de uma trajetória de agente offline e acrescenta uma camada a cada checkpoint: protocolos de mensagens e modelos, streaming, adaptadores de provedores, ferramentas, o loop do agente, árvores de sessão, compactação de contexto, extensões e um harness de avaliação independente.

Cada capítulo combina o texto do livro, um commit real no repositório que acompanha o curso, testes focados e experimentos de injeção de falhas. O código do curso é um histórico do Git que pode ser acessado, executado e verificado em cada etapa, em vez de pseudocódigo. O projeto está disponível como livro online e como servidor de desenvolvimento local criado com npm.

O curso não é oficial e foi escrito pela comunidade. O código é licenciado sob MIT e o conteúdo do livro, sob CC BY 4.0. O projeto também inclui uma CLI auxiliar que prepara os checkpoints e diretórios de prática para uso com um agente de aprendizado.

Recursos principais

  • 01Quinze checkpoints, cada um correspondente a um commit real que pode ser acessado e executado.
  • 02Aborda todo o percurso, dos tipos de mensagem e streaming aos adaptadores de provedores, ferramentas e ao loop do agente.
  • 03Inclui persistência de árvores de sessão e compactação de contexto para conversas longas.
  • 04Conclui com um sistema de extensões e uma avaliação independente do agente finalizado.
  • 05Oferece uma CLI para ir a um checkpoint ou gerar um diretório de exercícios sem respostas.

Casos de uso

  • Aprender como funciona internamente um agente de programação, criando um por conta própria.
  • Estudar padrões de TypeScript, como uniões discriminadas, fluxos de eventos e validação em tempo de execução, em um projeto realista.
  • Usar os checkpoints como um percurso de prática guiado junto com um agente tutor de IA.

Início rápido

  1. 1

    Clone o repositório do livro didático

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

    Acesse o diretório do projeto

    cd pi-textbook
  3. 3

    Instale as dependências

    npm install
  4. 4

    Inicie o servidor de desenvolvimento local

    npm run dev

Antes de usar

  • O livro didático foi escrito em chinês, então leitores de inglês podem ter dificuldade para acompanhar o conteúdo principal.
  • O código do curso fica em uma branch fork separada, por isso é necessário cloná-la para executar os checkpoints.

Tópicos

Perguntas frequentes

O que é pi-textbook?
Livro didático em chinês que ensina a criar, passo a passo, um agente de programação no estilo Pi em TypeScript, com 15 checkpoints executáveis do Git. Este curso ensina a criar do zero, em TypeScript, um agente de programação no estilo Pi. Ele parte de uma trajetória de agente offline e acrescenta uma camada a cada checkpoint: protocolos de mensagens e modelos, streaming, adaptadores de provedores, ferramentas, o loop do agente, árvores de sessão, compactação de contexto, extensões e um harness de avaliação independente.
pi-textbook é gratuito? Qual é a licença?
pi-textbook é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
pi-textbook ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de pi-textbook foi em 23 de jul. de 2026.
Para que posso usar pi-textbook?
Aprender como funciona internamente um agente de programação, criando um por conta própria. Estudar padrões de TypeScript, como uniões discriminadas, fluxos de eventos e validação em tempo de execução, em um projeto realista. Usar os checkpoints como um percurso de prática guiado junto com um agente tutor de IA.
Como instalar pi-textbook?
Clone o repositório do livro didático: git clone https://github.com/hahhforest/pi-textbook.git Acesse o diretório do projeto: cd pi-textbook Instale as dependências: npm install Inicie o servidor de desenvolvimento local: npm run dev
Onde consigo pi-textbook?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/hahhforest/pi-textbook

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados