Antes de começarScripts Python e terminal; download inicial de cerca de 3 GB em modelos.
IA & LLMsRAG local com Ollama.
LAB 02APRENDA CONSTRUINDO.
UM LAB. UM PROJETO COMPLETO.
DO CONCEITO À EXECUÇÃO
É isso que você vai construir.
Busque e converse com seus documentos usando modelos que rodam na sua máquina.
Você conecta embeddings, índice e geração de respostas em um RAG local, com API e interface. Depois de baixar os modelos, o projeto funciona sem internet.
O local-rag: um sistema que lê Markdown, texto e PDF, gera embeddings com um modelo local, indexa em SQLite, recupera por similaridade, responde com um modelo de linguagem local citando as fontes, recusa o que não sabe, expõe uma API com streaming e uma UI, e mede a própria latência e qualidade.
15 minpara o demo*
57páginas de conteúdo
17seções no ebook
*Estimativa do Lab. Preparação do ambiente e downloads podem acrescentar tempo.
DUAS PARTES. O MESMO PROJETO.
Um guia para entender. Um projeto para fazer.
Leia, execute e volte ao trecho que precisar. O ritmo é seu.
O ebook visual
57 páginas em português, com diagramas, decisões de implementação e exercícios nas seções práticas.
PDF · EDIÇÃO VISUAL
O repositório completo
Código, dados de exemplo, instruções de execução e 42 testes de unidade + 4 de integração com Ollama (opcional). Inclui o ambiente Docker do projeto.
Depois da compra, o repositório do Lab é enviado por e-mail e WhatsApp para o cadastro feito na Hotmart.
CÓDIGO · TESTES · DOCUMENTAÇÃO
O CAMINHO DO LAB
Saiba onde você vai chegar.
17 seções para acompanhar o projeto, do ambiente aos próximos passos.
Edição visual · 57 páginas
01Introdução+
Conheça um RAG que mantém documentos, embeddings e geração na sua máquina. Veja o resultado esperado, os pré-requisitos e a proposta de execução com modelos locais.
02Ambiente Python e Ollama+
Prepare o Python e o Ollama, baixe os modelos do laboratório e valide a instalação. Execute o demo para conferir a comunicação entre a aplicação e os modelos.
03Requirements explicados+
Entenda como FastAPI, numpy, pypdf e o cliente Ollama se encaixam no projeto. Diferencie as bibliotecas instaladas pelo pip dos modelos baixados separadamente.
04O mapa do sistema+
Siga o caminho dos documentos até o índice e da pergunta até a resposta em streaming. Localize os módulos de configuração, recuperação e geração.
05Por que IA local muda custo e privacidade+
Compare inferência local e serviços na nuvem em privacidade, custo e uso de hardware. Entenda as etapas do RAG local e os limites dos modelos menores.
06O Ollama por dentro+
Use os comandos e a API HTTP do Ollama para inspecionar modelos, memória e execução. Conheça o cliente Python e o backend simulado usado no desenvolvimento.
07Indexar documentos com modelos locais+
Carregue e divida documentos, gere embeddings locais em lote e grave o índice em SQLite. Entenda por que o índice precisa registrar qual modelo o produziu.
08Montar o fluxo de retrieval+
Recupere trechos por similaridade de cosseno e inspecione a pontuação dos candidatos. Ajuste o limiar que decide entre responder e recusar uma pergunta.
09Conectar o modelo do Ollama+
Configure o prompt, envie o contexto ao modelo de chat e interprete as métricas retornadas. Produza respostas com citações e acompanhe a geração em streaming.
10A API de chat e a UI+
Conecte a API de chat à interface web e experimente JSON e streaming. Veja como o serviço informa indisponibilidade do Ollama sem esconder o motivo da falha.
11Medir latência e qualidade+
Execute perguntas com gabarito e compare qualidade, recusas e latência. Use os resultados para escolher modelos de embeddings e chat e calibrar o limiar de resposta.
12Testes+
Separe testes rápidos com backend simulado dos testes opcionais com modelos reais. Entenda o que cada grupo valida e como executar a integração com Ollama.
13Rodar com Docker+
Execute aplicação e Ollama pelo Compose ou mantenha o Ollama nativo no computador. Configure a comunicação entre eles e disponibilize seus documentos ao container.
14Troubleshooting+
Investigue servidor Ollama indisponível, modelos ausentes e erros de instalação. Use a tabela de sintomas para localizar a configuração ou dependência que precisa de ajuste.
15Custos, limites e caminhos para produção+
Avalie disco, memória, latência e os limites do índice local. Identifique o que precisaria mudar para atender mais usuários e operar além do laboratório.
16Próximos passos+
Experimente seus documentos, compare novos modelos e planeje histórico de conversa. Explore busca híbrida, reindexação incremental e formas de ampliar a capacidade de inferência.
17Checklist final+
Revise instalação, modelos, índice, recuperação e respostas citadas. Confirme também o funcionamento da interface, dos testes e das medições de qualidade e latência.
PARA COMEÇAR COM CLAREZA
Seu ponto de partida.
Conhecimento prévio
Scripts Python e terminal; download inicial de cerca de 3 GB em modelos. Nível: Python intermediário.
Ferramentas do projeto
Python, Ollama, FastAPI, SQLite. As instruções de instalação e as versões estão no pacote.
Custo para executar
Zero. Sem chave de API, sem serviço pago, sem internet depois de baixar os modelos.
Tempo para aprender
4–5 h estimadas para ler, executar e entender. Você pode dividir o estudo em várias sessões.