Conteúdo detalhado
🖼️ Por que uma interface gráfica
O terminal foi ótimo para o seu primeiro "olá": prova que o modelo roda. Mas para usar de verdade no dia a dia ele cansa — sem histórico, sem trocar de modelo fácil, sem colar um PDF. Uma interface gráfica resolve isso e te dá um ChatGPT que mora na sua máquina.
🆕 Novo aqui?
"Interface gráfica" (GUI) é a janela com botões, caixas de texto e menus — o oposto do terminal de linha de comando. "Backend" é a peça invisível que faz o trabalho pesado (aqui, o Ollama rodando o modelo); a interface só conversa com ele e mostra o resultado bonito na tela.
✗ Só terminal
- ✗Fechou a janela, perdeu a conversa
- ✗Trocar de modelo = digitar comando de novo
- ✗Não dá pra anexar arquivo ou imagem
- ✗Nada de pesquisar chats antigos
✓ Interface gráfica
- ✓Histórico salvo e pesquisável
- ✓Menu para trocar de modelo num clique
- ✓Anexar documentos, imagens e código
- ✓Vários chats abertos lado a lado
🌐 Open WebUI: o que é
O Open WebUI é um front-end web de código aberto que se conecta ao Ollama — ou a qualquer API compatível com a da OpenAI — e te entrega uma tela de chat completa. Ele roda na sua própria máquina e abre no navegador, normalmente em localhost:3000.
🆕 Novo aqui?
"Front-end web" é a parte que você vê e clica, servida como uma página de internet. "localhost" é um apelido para a sua própria máquina — quando você abre localhost:3000, nada sai para a internet; o navegador só fala com um programa rodando aí mesmo, na porta 3000.
🔑 A ideia central
Open WebUI separa quem mostra de quem pensa:
- •Open WebUI cuida da tela: chats, histórico, anexos, login.
- •Ollama cuida do cérebro: carrega o modelo e gera o texto.
- •Os dois conversam por uma API local — e tudo continua na sua máquina, offline.
📋 O que ele te dá de cara
- Chat com histórico, organização por pastas e busca.
- Troca de modelo pelo menu (todos os que você baixou no Ollama aparecem).
- Suporte a vários usuários com login — útil para a família ou o time.
- Upload de documentos para perguntar sobre eles (a base do RAG, tema do módulo 3.6).
🐳 Subir com Docker
A forma mais limpa de instalar o Open WebUI é com Docker. Um comando baixa a aplicação inteira já pronta e a coloca no ar — sem mexer em dependências do seu sistema.
🆕 Novo aqui?
"Docker" empacota um programa com tudo de que ele precisa numa "caixa" isolada (um container). Você não instala biblioteca por biblioteca: roda o container e funciona igual em qualquer máquina. Instale o Docker Desktop (Windows/macOS) ou o Docker Engine (Linux) antes de seguir.
Ollama já rodando
Garanta que o Ollama do módulo 3.1 está ativo (ollama list mostra seus modelos). É ele o backend que a interface vai usar.
Rodar o container
Um único docker run baixa a imagem e sobe o Open WebUI já conectado ao Ollama da sua máquina.
Abrir no navegador
Acesse localhost:3000, crie a primeira conta (vira o admin) e comece a conversar.
⌨️ Exemplo prático: subir o Open WebUI
Objetivo: colocar a interface de chat no ar conectada ao seu Ollama. Cole no terminal (uma linha só).
Lendo o comando: -d roda em segundo plano · -p 3000:8080 abre a porta 3000 no seu PC · --add-host deixa o container achar o Ollama na máquina hospedeira · -v open-webui:... guarda seus chats mesmo que o container reinicie.
Como verificar: abra http://localhost:3000 no navegador. Apareceu a tela de criar conta? Está no ar. Rode docker ps e confira o container open-webui com status Up.
💡 Dica prática
No Linux, se o container não enxergar o Ollama, rode o Ollama com OLLAMA_HOST=0.0.0.0 para ele aceitar conexões da rede do Docker. Para atualizar a interface depois: docker pull ghcr.io/open-webui/open-webui:main e recrie o container — seus chats ficam salvos no volume.
🖥️ LM Studio: alternativa desktop
Nem todo mundo quer mexer com Docker. O LM Studio é um aplicativo de desktop que você instala como qualquer programa: ele baixa modelos no formato GGUF, traz um chat embutido e ainda liga um servidor local — tudo numa janela só.
🆕 Novo aqui?
"GGUF" é o formato de arquivo em que os modelos abertos vêm empacotados para rodar em CPU/GPU — você vai aprofundar isso no módulo 3.3. "Servidor local embutido" quer dizer que o LM Studio também oferece uma API na sua máquina, igual ao Ollama, para seus apps se conectarem.
✓ Prefira o LM Studio quando
- ✓Você quer clicar e instalar, sem terminal nem Docker
- ✓Gosta de explorar e baixar modelos GGUF por uma loja visual
- ✓Quer ajustar parâmetros com sliders, vendo o efeito na hora
- ✓Chat e servidor local na mesma janela bastam pra você
⚙️ Prefira Ollama + Open WebUI quando
- •Quer rodar como serviço sempre-on, sem app aberto na tela
- •Precisa de vários usuários com login no navegador
- •Vai acessar de outros dispositivos pela rede (Tailscale)
- •Quer scriptar tudo por linha de comando
🤝 Não é "um ou outro"
Os dois caminhos chegam ao mesmo lugar: um modelo local com chat e API. Muita gente usa o LM Studio para experimentar e comparar modelos no desktop, e o Ollama + Open WebUI para o lab que fica ligado servindo a casa toda. Comece pelo que for menos atrito para você hoje.
🔌 Conectando interface ↔ backend
Com o Open WebUI no ar, falta apontar a interface para o backend certo. Quando o Ollama está na mesma máquina, costuma funcionar de primeira; se algo não aparece, é quase sempre a URL da conexão.
Apontar para o Ollama
Em Configurações → Conexões, a URL do Ollama deve ser http://host.docker.internal:11434 (interface no Docker) ou http://localhost:11434 (instalação direta).
Escolher o modelo
No topo do chat, o seletor lista todos os modelos que você baixou (ollama pull). Troque entre um qwen2.5:7b e um gemma2:2b sem reiniciar nada.
Definir o system prompt
Na configuração do modelo (ou do chat) você escreve o system prompt — a instrução de fundo que dá personalidade e regras: "responda em PT-BR, conciso, com exemplos". Tema aprofundado no módulo 3.4.
🧭 Se um modelo não aparece
- Confirme que ele existe: ollama list no terminal.
- Confirme que o Ollama responde: curl http://localhost:11434/api/tags deve devolver a lista.
- No Open WebUI, revise a URL da conexão e clique em verificar/atualizar.
🚀 Recursos que destravam uso real
A interface não é só estética: ela abre portas que o terminal não tinha. Antes de listar os recursos, fixe o modelo mental da pilha — navegador → Open WebUI → Ollama → modelo, uma camada dentro da outra:
Leia de fora para dentro: tudo acontece no seu navegador. O Open WebUI recebe sua pergunta e a entrega ao Ollama, que aciona o modelo (em roxo). A resposta volta pela camada de ciano até a tela. Nenhuma seta sai da máquina.
🎯 O que a interface destrava
- •Múltiplos chats: uma conversa por assunto, organizadas e pesquisáveis.
- •RAG de documentos: suba PDFs e pergunte sobre eles — a base do módulo 3.6.
- •Perfis de prompt: salve system prompts reutilizáveis ("revisor", "tradutor", "tutor").
- •Usuários: contas separadas com login — a casa ou o time inteiros usando um só lab.
Auto-checagem (opcional): no Open WebUI, quem é o backend que realmente gera o texto?
📌 Resumo do módulo
Próximo módulo:
3.3 — Escolhendo e baixando o modelo certo