Repolode
Enviar
SaladDay

SaladDay/pi-from-scratch

Um tutorial passo a passo para criar do zero um agente de programação mínimo em TypeScript, capaz de ler arquivos, editar código e executar comandos.

Ver no GitHubSite
Estrelas
1,303
Forks
108
Issues abertas
1
Último commit
há 14 dias

O que é?

PI from Scratch é um tutorial prático que recria as ideias centrais do agente de programação pi em cerca de 600 linhas de TypeScript, chamado nano-pi. Ele acompanha o fluxo de dados do pi e implementa cada componente apenas até o necessário para entendê-lo, sem os detalhes de engenharia para produção.

O projeto é apresentado como um artigo fácil de acompanhar, acompanhado do código-fonte. No site complementar, o código no editor é preenchido aos poucos conforme você lê, e um recurso de rastreamento permite percorrer a execução linha por linha com breakpoints. O agente funciona com qualquer API compatível com OpenAI, configurada por variáveis de ambiente para a chave da API, o nome do modelo e a URL base.

Os rastreamentos disponíveis online são dados estáticos pré-gerados, então navegar pelo site não gera solicitações ao modelo. Para executar o nano-pi localmente, é necessário usar Node.js 22 ou posterior.

Recursos principais

  • 01Cria um agente de programação que lê arquivos, edita código e executa comandos do shell.
  • 02Segue o fluxo de dados do pi, mantendo apenas as ideias centrais do design.
  • 03Combina o texto do artigo com código-fonte que é preenchido aos poucos no editor.
  • 04Inclui um visualizador de rastreamento para percorrer a execução do código com breakpoints.
  • 05Funciona com qualquer API compatível com OpenAI por meio de variáveis de ambiente.

Casos de uso

  • Aprender como funcionam internamente o loop de um agente de programação, as chamadas de ferramentas e a edição de arquivos.
  • Criar seu próprio agente pequeno como ponto de partida antes de estudar o pi em profundidade.
  • Ensinar arquitetura de agentes em workshops ou cursos.

Início rápido

  1. 1

    Instale o Node.js 22 ou posterior e obtenha uma chave de API compatível com OpenAI

  2. 2

    Instale as dependências

    npm install
  3. 3

    Configure sua chave de API

    export NANOPI_API_KEY=your-api-key
  4. 4

    Inicie o projeto

    npm run dev

Antes de usar

  • É necessária uma chave de API compatível com OpenAI para executar o agente.

Destaque no Repolode Weekly

Em coleções

Frameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IA

Tópicos

#ai-agent#coding-agent#llm#tool-calling#typescript#tutorial#agent-loop#llm-agent#pi#pi-agent

Perguntas frequentes

O que é pi-from-scratch?
Um tutorial passo a passo para criar do zero um agente de programação mínimo em TypeScript, capaz de ler arquivos, editar código e executar comandos. PI from Scratch é um tutorial prático que recria as ideias centrais do agente de programação pi em cerca de 600 linhas de TypeScript, chamado nano-pi. Ele acompanha o fluxo de dados do pi e implementa cada componente apenas até o necessário para entendê-lo, sem os detalhes de engenharia para produção.
pi-from-scratch é gratuito? Qual é a licença?
pi-from-scratch é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
pi-from-scratch ainda é mantido?
Manutenção ativa. O último commit de pi-from-scratch foi em 24 de out. de 2026.
Para que posso usar pi-from-scratch?
Aprender como funcionam internamente o loop de um agente de programação, as chamadas de ferramentas e a edição de arquivos. Criar seu próprio agente pequeno como ponto de partida antes de estudar o pi em profundidade. Ensinar arquitetura de agentes em workshops ou cursos.
Como instalar pi-from-scratch?
Instale o Node.js 22 ou posterior e obtenha uma chave de API compatível com OpenAI Instale as dependências: npm install Configure sua chave de API: export NANOPI_API_KEY=your-api-key Inicie o projeto: npm run dev
Onde consigo pi-from-scratch?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/SaladDay/pi-from-scratch

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

Projetos relacionados