Biblioteca Python e livro didático executável em Jupyter que implementa 35 arquiteturas de IA agêntica, de Reflexion e ReAct a MemGPT e BrowserAgent, com LangGraph.
Moh4696/build-ai-agents-free
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.
- Estrelas
- 369
- Forks
- 115
- Issues abertas
- 2
- Último commit
- há 3 meses
O que é?
Este tutorial para iniciantes ensina a criar um agente de IA em Python sem pagar por nenhuma API. Ele explica o ciclo de planejar, agir e observar, que diferencia um agente de um chatbot comum, e mostra como executar esse ciclo com o create_agent do LangChain e o modelo gratuito Llama 3.3 70B do Groq.
O guia desenvolve o agente passo a passo. Começa com um agente mínimo e, em seguida, adiciona uma ferramenta pronta de busca na web com DuckDuckGo e uma ferramenta personalizada word_count, definida com o decorator @tool. Depois, adiciona memória de conversa usando um checkpointer InMemorySaver e thread_id e, por fim, um fallback que muda do Groq para o Google Gemini quando o provedor principal falha. Cada etapa tem um script correspondente na pasta src do repositório, e o agent.py reúne tudo.
O tutorial é voltado a quem não tem experiência prévia com agentes e quer evitar chaves de API pagas. Também aponta as limitações da configuração gratuita, como limites de requisições na ferramenta de busca, a perda da memória quando o script é encerrado e a possibilidade de provedores com planos gratuitos usarem os prompts para treinamento.
Recursos principais
- 01Cria um agente funcional com o create_agent do LangChain e o modelo gratuito Llama 3.3 70B do Groq.
- 02Adiciona uma ferramenta de busca na web com DuckDuckGo que não exige chave de API.
- 03Mostra como transformar qualquer função Python em uma ferramenta com o decorator @tool.
- 04Adiciona memória para conversas com várias interações usando um checkpointer InMemorySaver e thread_id.
- 05Demonstra o fallback de provedor do Groq para o Google Gemini em caso de falha.
- 06Inclui um script executável para cada etapa e um agent.py que reúne tudo.
Casos de uso
- Aprender do zero o ciclo de planejar, agir e observar dos agentes de IA.
- Prototipar um agente que usa ferramentas sem uma chave de API paga.
- Ensinar os fundamentos de LangChain e LangGraph em uma oficina para iniciantes.
- Criar um projeto pessoal que precise de um fallback quando um dos provedores gratuitos estiver indisponível.
Início rápido
- 1
Verifique se o Python 3.10 ou uma versão mais recente está instalado
python3 --version - 2
Crie uma pasta para o projeto e acesse-a
mkdir my-agent cd my-agent - 3
Instale langchain, o conector do Groq e python-dotenv
pip install -U "langchain[groq]" python-dotenv - 4
Obtenha uma Groq API key gratuita em console.groq.com e salve-a em um arquivo .env. Em seguida, execute o primeiro script do agente
python3 agent.py
Antes de usar
- Os níveis gratuitos dos modelos podem mudar sem aviso, e a maioria dos provedores pode usar seus prompts para treinamento. Portanto, não inclua dados confidenciais.
- A ferramenta de busca DuckDuckGo limita o uso intenso e pode falhar ocasionalmente.
- InMemorySaver mantém a memória da conversa apenas na RAM, então ela é perdida quando o script é encerrado.
Tópicos
Perguntas frequentes
- O que é build-ai-agents-free?
- 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. Este tutorial para iniciantes ensina a criar um agente de IA em Python sem pagar por nenhuma API. Ele explica o ciclo de planejar, agir e observar, que diferencia um agente de um chatbot comum, e mostra como executar esse ciclo com o create_agent do LangChain e o modelo gratuito Llama 3.3 70B do Groq.
- build-ai-agents-free é gratuito? Qual é a licença?
- build-ai-agents-free é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- build-ai-agents-free ainda é mantido?
- Atualizado nos últimos 6 meses. O último commit de build-ai-agents-free foi em 8 de jul. de 2026.
- Para que posso usar build-ai-agents-free?
- Aprender do zero o ciclo de planejar, agir e observar dos agentes de IA. Prototipar um agente que usa ferramentas sem uma chave de API paga. Ensinar os fundamentos de LangChain e LangGraph em uma oficina para iniciantes. Criar um projeto pessoal que precise de um fallback quando um dos provedores gratuitos estiver indisponível.
- Como instalar build-ai-agents-free?
- Verifique se o Python 3.10 ou uma versão mais recente está instalado: python3 --version Crie uma pasta para o projeto e acesse-a: mkdir my-agent cd my-agent Instale langchain, o conector do Groq e python-dotenv: pip install -U "langchain[groq]" python-dotenv Obtenha uma Groq API key gratuita em console.groq.com e salve-a em um arquivo .env. Em seguida, execute o primeiro script do agente: python3 agent.py
- Onde consigo build-ai-agents-free?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Moh4696/build-ai-agents-free
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
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.
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.
Framework Python de baixo nível para criar agentes com estado e execução durável, com participação humana e memória.
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.
Um harness de agentes para Python, com escolhas opinativas e tudo incluído, que executa tarefas longas e com várias etapas desde o início no LangGraph.