Skip to main content
Este tutorial passo a passo vai te guiar para montar um setup robusto, perfeito para rodar modelos de linguagem localmente e construir pipelines RAG (Retrieval-Augmented Generation) com SingleStore ou ChromaDB. Tudo isso com privacidade total e sem custos de API!

Guia de Configuração: AI Agents com Ollama e LangChain

Objetivo

Configurar um ambiente funcional para desenvolver e testar agentes de IA localmente, com suporte para modelos de linguagem (LLMs) e armazenamento vetorial. Ideal para iniciantes e experts!

Pré-requisitos

Sistema Operacional
  • Windows 11/10 ou MacOS (Ventura ou posterior recomendado).
Hardware
  • Mínimo: 8 GB de RAM
  • Recomendado: 16 GB de RAM
  • Espaço livre: 10 GB
Software
  • Python 3.9+ instalado.
  • Docker Desktop instalado e em execução (para SingleStore, se desejar).
  • Terminal: PowerShell (Windows) ou Terminal (MacOS).
  • Conexão à internet para baixar modelos e dependências (após configuração, tudo roda offline!).

Passo a Passo

Passo 1: Instalar o Ollama

O Ollama permite rodar modelos de linguagem localmente com facilidade. Download e Instalação MacOS
Ou baixe o instalador em ollama.com e siga as instruções. Verificar instalação
Deve retornar 0.1.x ou superior Baixar Modelos

Passo 2: Configurar o Ambiente Python

Um ambiente virtual mantém tudo organizado e isolado. Verificar Python MacOS
Se não instalado:
Windows
Se não instalado, baixe de python.org. Criar diretório do projeto mkdir ai-agent-project cd ai-agent-project Criar e ativar ambiente virtual MacOS
Windows
Instalar dependências
Opcional (usando Poetry)

Passo 3: Configurar o SingleStore (Opcional para RAG)

Instalar Docker MacOS
Windows Baixe em docker.com. Inicie o Docker Desktop O script no Passo 4 já inicializa o SingleStore automaticamente.

Passo 4: Criar o Agente de IA

Criar arquivo de dados (opcional)
Title,Date,Rating,Review “Best Pizza in Town!”,“2025-01-06”,1,“The crust was perfectly crispy and the toppings were fresh.” “Delicious and Affordable”,“2024-08-12”,1,“A bit overpriced, but overall a decent meal.” Criar script Python
Executar Certifique-se de que o Ollama está rodando:
Depois:
Ou com Poetry:

Passo 5: Testar e Personalizar

Testar exemplo Digite: O que as pessoas acham da crosta da pizza? Personalizar Trocar modelo (llama3.2 → mistral, qwen2:7b etc.). Adicionar mais dados ao pizza_reviews.csv. Integrar ferramentas externas (acesso web, arquivos, etc.).

Passo 6: Solução de Problemas

Ollama não conecta
Modelo não encontrado
Erro de módulo Python

Passo 7: Próximos Passos

Adicionar interface web com Streamlit Testar com ChromaDB Implementar multi-agentes Adicionar memória de conversação

Notas Finais

100% Local: Privacidade garantida, sem APIs externas.

Recursos Úteis Documentação Ollama

LangChain DocsSingleStore TutorialsDocumentação do OllamaDocumentação do LangChainTutoriais da SingleStoreAgora você está pronto para construir agentes de IA incríveis! 🎉