Projeto educacional passo a passo que implementa RAG do zero em JavaScript, usando LLMs locais e sem APIs na nuvem.
1,6 mil205JavaScriptMITAtualizado há 7 meses
pguso/ai-agents-from-scratch
Tutorial prático que ensina a criar agentes de IA do zero com LLMs locais via node-llama-cpp, abordando chamadas de função, memória e ReAct.
- Estrelas
- 4,871
- Forks
- 721
- Issues abertas
- 12
- Último commit
- há 3 meses
O que é?
AI Agents From Scratch é um repositório de aprendizado para criar agentes de IA em JavaScript sem depender de frameworks de agentes. Ele executa modelos GGUF localmente por meio do node-llama-cpp, permitindo que os leitores vejam cada prompt, chamada de ferramenta e iteração do loop diretamente no código, em vez de tudo ficar oculto por uma camada de abstração.
O material é organizado em 15 exemplos sequenciais. Eles avançam do carregamento básico de modelos e prompts de sistema até streaming, processamento em lote e chamadas de função, passando por memória persistente, o loop ReAct de raciocínio e ação, tratamento de erros e padrões mais recentes, como Tree of Thought, Graph of Thought, Chain of Thought e roteamento de ferramentas baseado em embeddings. Cada pasta de exemplo inclui um script executável, além das explicações em CODE.md e CONCEPT.md.
O projeto requer Node.js 18+ e pelo menos 8 GB de RAM. Os modelos ficam em uma pasta local chamada models, conforme as instruções de download incluídas. O site complementar agentsfromscratch.com traz explicações conceituais junto com o código, e uma versão do tutorial em Python é mantida separadamente.
Recursos principais
- 01Executa modelos GGUF localmente por meio do node-llama-cpp, sem exigir chaves de API na nuvem
- 02Aborda chamadas de função com definições de ferramentas em JSON Schema
- 03Inclui um loop de agente ReAct com etapas de raciocínio, ação e observação
- 04Demonstra memória persistente para guardar fatos e preferências entre sessões
- 05Oferece tratamento de erros com novas tentativas, timeouts e alternativas
- 06Cada exemplo inclui código, uma explicação linha por linha e notas conceituais
Casos de uso
- Desenvolvedores que querem entender como os agentes funcionam internamente antes de adotar LangChain ou frameworks semelhantes
- Engenheiros que estão aprendendo chamadas de função e uso de ferramentas com um modelo local pequeno
- Equipes que desenvolvem protótipos de LLM offline ou com requisitos de privacidade em Node.js
- Instrutores preparando um curso prático sobre arquiteturas de agentes
Início rápido
- 1
Instale o Node.js 18+ e baixe os modelos para ./models/ (consulte DOWNLOAD.md)
- 2
Instale as dependências
npm install - 3
Execute o exemplo introdutório
node intro/intro.js - 4
Execute o exemplo de agente simples
node simple-agent/simple-agent.js
Antes de usar
- É necessário baixar modelos GGUF locais e ter pelo menos 8 GB de RAM (16 GB recomendados).
- É um tutorial com exemplos, não um framework para produção.
Tópicos
Perguntas frequentes
- O que é ai-agents-from-scratch?
- Tutorial prático que ensina a criar agentes de IA do zero com LLMs locais via node-llama-cpp, abordando chamadas de função, memória e ReAct. AI Agents From Scratch é um repositório de aprendizado para criar agentes de IA em JavaScript sem depender de frameworks de agentes. Ele executa modelos GGUF localmente por meio do node-llama-cpp, permitindo que os leitores vejam cada prompt, chamada de ferramenta e iteração do loop diretamente no código, em vez de tudo ficar oculto por uma camada de abstração.
- ai-agents-from-scratch é gratuito? Qual é a licença?
- ai-agents-from-scratch é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- ai-agents-from-scratch ainda é mantido?
- Atualizado nos últimos 6 meses. O último commit de ai-agents-from-scratch foi em 24 de jul. de 2026.
- Para que posso usar ai-agents-from-scratch?
- Desenvolvedores que querem entender como os agentes funcionam internamente antes de adotar LangChain ou frameworks semelhantes Engenheiros que estão aprendendo chamadas de função e uso de ferramentas com um modelo local pequeno Equipes que desenvolvem protótipos de LLM offline ou com requisitos de privacidade em Node.js Instrutores preparando um curso prático sobre arquiteturas de agentes
- Como instalar ai-agents-from-scratch?
- Instale o Node.js 18+ e baixe os modelos para ./models/ (consulte DOWNLOAD.md) Instale as dependências: npm install Execute o exemplo introdutório: node intro/intro.js Execute o exemplo de agente simples: node simple-agent/simple-agent.js
- Onde consigo ai-agents-from-scratch?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pguso/ai-agents-from-scratch
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Tutorial gratuito, passo a passo, para criar um agente de IA em Python com LangChain e LangGraph usando os modelos gratuitos dos planos free do Groq e do Gemini.
369115PythonMITAtualizado há 3 meses
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.
78,8 mil12,6 milPythonMITAtualizado há 22 dias
Curso gratuito com licença MIT e 542 lições que ensina conceitos de engenharia de IA do zero em Python, TypeScript, Rust e Julia.
71,4 mil12,6 milPythonMITAtualizado ontem
Tutorial comentado em 12 capítulos que ensina a criar e treinar do zero, em Python e PyTorch, um GPT pequeno no estilo LLaMA.
4 mil505Jupyter NotebookMITAtualizado há 2 meses
SDKs para TypeScript e Python que dão a agentes de IA acesso a mais de 1.000 toolkits de apps pré-autenticados, sessões por usuário e um sandbox para executar ações.
30,6 mil4,9 milTypeScriptMITAtualizado há 12 horas