Tutorial bilíngue e análise do código-fonte do Pi-Agent SDK, com projetos de código complementares e uma skill para assistentes de IA criarem agentes.
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
Clone o repositório do livro didático
git clone https://github.com/hahhforest/pi-textbook.git - 2
Acesse o diretório do projeto
cd pi-textbook - 3
Instale as dependências
npm install - 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
Tutorial de Python com 17 lições que cria do zero um harness de agente semelhante ao Claude Code, começando com um único loop e bash.
Workshop passo a passo em Go que ensina a criar um agente de programação com a Claude API, adicionando ferramentas de arquivos, shell e busca uma de cada vez.
Manual comunitário não oficial em chinês para o harness de terminal Pi Coding Agent, da configuração a Skills, Extensions, Subagents e fluxos de trabalho de longa duração.
Agente de programação autônomo e open source que funciona como extensão de IDE, CLI de terminal, app para desktop ou SDK.
Agente de programação para terminal com ferramentas integradas de LSP, debugger, navegador e subagentes, compatível com mais de 60 provedores de modelos.