Como conectar sua IA local a um chat (OpenWebUI) Print

Como Conectar sua IA Local a um Chat (OpenWebUI)

Oi! Aqui é o Sensei da GeHost 😊 Você quer colocar uma inteligência artificial rodando no seu próprio computador e conversar com ela por um chat amigável? Ótimo! Este guia é feito especialmente pra quem tá chegando nesse universo agora. Não precisa ser expert — vamos lá passo a passo.

O que você vai fazer aqui?

Basicamente, você vai:

1. Instalar uma ferramenta chamada OpenWebUI (é um chat web bem bonito)
2. Conectar ela a um modelo de IA rodando localmente no seu PC
3. Conversar com sua IA sem enviar nada pra nuvem — fica tudo com você

Antes de começar — o que você precisa saber

O que é IA local? É um modelo de inteligência (tipo ChatGPT, mas funcionando no seu computador) que roda direto na sua máquina. Nenhum dado sai pra internet. É seguro, privado e funciona offline.

O que é OpenWebUI? É uma interface web linda e fácil pra você conversar com a IA. Pensa numa versão "bonita" do ChatGPT que roda no seu próprio servidor caseiro.

💡 Dica do Sensei: Você já usa hospedagem da GeHost? Perfeito — pode rodar isso num servidor dedicado ou até numa máquina local. O importante é ter espaço em disco e memória RAM suficiente.

Pré-requisitos (o que você precisa)

• Um computador com Linux, macOS ou Windows (com pelo menos 8 GB de RAM, idealmente 16 GB)
• Docker instalado (é um programa que deixa tudo "empacotado" e fácil — recomendamos)
• Internet (só pra baixar os arquivos; depois roda offline)
• Um pouco de paciência (a primeira instalação leva tempo porque baixa o modelo de IA — uns 5-20 GB)

Não sabe o que é Docker? Sem problema — explicamos na próxima seção.

Passo 1: Instale o Docker

Docker é um "container" — pensa nele como um pacote que já vem tudo pronto, sem você ter que configurar cada detalhe. Bem mais fácil.

Windows ou Mac:

1. Vá até docker.com/products/docker-desktop
2. Clique em "Download" e escolha sua plataforma
3. Instale normalmente (como qualquer programa)
4. Abra e deixe rodando em background (vai aparecer um ícone na bandeja)

Linux (Ubuntu/Debian):

1. Abra o terminal e rode:
   1. sudo apt update
   2. sudo apt install docker.io -y
   3. sudo usermod -aG docker $USER
2. Reinicie ou rode: newgrp docker

✅ Como saber se deu certo: Abra o terminal/prompt e digite docker --version. Se retornar um número (tipo "Docker version 24.0.1"), tá pronto.

Passo 2: Instale o Ollama (a IA local)

Ollama é um programa que baixa e roda modelos de IA no seu PC. É super simples de usar.

1. Vá até ollama.ai (agora é ollama.com)
2. Clique em "Download" e escolha seu sistema (Windows, Mac, Linux)
3. Instale como um programa normal
4. Abra o terminal/prompt e rode: ollama serve (vai deixar o servidor rodando)

Pronto! Ollama tá na escuta. Deixe essa janela aberta (ou deixe rodar em background).

💡 Dica: A primeira vez que você roda, o Ollama baixa o modelo padrão (Llama 2, uns 4-7 GB). Isso leva tempo. Faz café ☕ e aproveita pra ler a próxima seção!

Passo 3: Instale o OpenWebUI (via Docker)

Agora vem a parte legal — o chat bonito. Vamos usar Docker pra fazer isso super rápido.

1. Abra o terminal/prompt
2. Cole este comando:
   1. docker run -d --name open-webui -p 3000:8080 --add-host=host.docker.internal:host-gateway ghcr.io/open-webui/open-webui:latest
3. Espere uns 30 segundos (tá baixando a imagem)

Pronto! OpenWebUI tá instalado.

Passo 4: Acesse o OpenWebUI e configure a conexão

1. Abra seu navegador (Chrome, Firefox, Safari, qualquer um)
2. Digite na barra: localhost:3000
3. Vai aparecer uma tela de login bonitinha
4. Na primeira vez, crie uma conta (e-mail + senha simples)
   1. E-mail: pode ser qualquer um (tipo seu@email.com)
   2. Senha: algo que você lembre
5. Clique em "Sign up" ou "Entrar"

Passo 5: Conecte o OpenWebUI ao Ollama

Agora vem o "segredo" — configurar pra conversar com sua IA local.

1. Dentro do OpenWebUI, clique no seu ícone de perfil (geralmente canto superior direito)
2. Vá para Settings (ou Configurações)
3. Procure por Ollama (ou "Connection Settings")
4. No campo Ollama API Endpoint, digite:
   1. http://host.docker.internal:11434 (se estiver no Docker)
   2. OU http://localhost:11434 (se instalou direto no PC)
5. Clique em "Save" ou "Salvar"

🤔 Por que esse número estranho (11434)? É a porta padrão que o Ollama usa. É como um "telefone" que o OpenWebUI usa pra falar com a IA. Fica tranquilo — Ollama já usa essa porta automaticamente.

Passo 6: Escolha seu modelo de IA e comece a conversar!

1. Volte à tela principal do OpenWebUI
2. Na caixa de chat (onde você normalmente tipo mensagens), tem um dropdown (▼) que diz "Select a model"
3. Clique e escolha um modelo (ex.: Llama 2 se já baixou)
4. Digite uma mensagem simples pra testar: "Oi, tudo bem?"
5. Aperte Enter

Pronto! Sua IA respondeu. Você tá conversando com uma inteligência rodando no seu PC. Manda brasa! 🚀

💡 Mais modelos? Quer um modelo diferente? Volte no terminal e rode ollama pull nome-do-modelo (ex.: ollama pull mistral, ollama pull neural-chat). Cada um tem um "jeitão" — experimenta alguns!

Troubleshooting — "Algo não deu certo"

Problema: "Não consigo acessar localhost:3000"

• Verifique se o Docker tá rodando (procure pela vírgula nas configurações ou abra o Docker Desktop)
• Verifique se a porta 3000 não tá bloqueada por outro programa
• Tente http://127.0.0.1:3000 em vez de localhost:3000

Problema: "OpenWebUI não acha o Ollama"

• Certifique-se de que ollama serve tá rodando (abra um terminal novo e rode de novo)
• Verifique o URL do Ollama nas configurações — teste se bate com seu ambiente
• Se rodou Ollama direto (sem Docker), use http://localhost:11434

Problema: "A resposta da IA é muito lenta"

• É normal na primeira vez — IA local é mais lenta que nuvem, mas só no começo
• Seu PC precisa de RAM — 16 GB roda melhor
• Feche outros programas pesados (jogos, vídeos, abas do navegador)

💡 Se não deu certo e tá perdido: Volta um passo. Tecla do Sensei: comece pelo Docker, depois Ollama, depois OpenWebUI. Ordem importa. Se quiser conversar com alguém, avisa — tem sempre um humano da GeHost pra ajudar!

Segurança — proteja sua IA

• Se rodando localmente: OpenWebUI só é acessível no seu PC (localhost:3000). Bem seguro.
• Se rodando num servidor (VPS da GeHost): Use uma senha FORTE pra sua conta OpenWebUI, e considere colocar atrás de um firewall ou senha HTTP extra.
• Nada sai da internet: Sua IA local não envia dados pra OpenAI, Google ou ninguém — fica tudo com você.

Próximos passos — depois que tá tudo funcionando

• Brinque com diferentes modelos (Mistral, Neural Chat, Orca) — cada um tem um "tom" diferente
• Crie "personagens" — pergunte à IA coisas específicas e veja como ela se adapta
• Se tiver um servidor da GeHost, considere rodar isso lá — mais estável e sempre online
• Explore as configurações avançadas do OpenWebUI (tem temas, atalhos, tudo)

✨ Recado final do Sensei: Você agora é o dono da sua IA. Sem intermediários, sem dados na nuvem, sem anúncios. Aproveita bem! E lembra: se precisar de hospedagem pra rodar isso 24/7 com confiança, a GeHost tá aqui. 😊

Precisa de ajuda?

Qualquer dúvida neste guia, entre em contato com o suporte da GeHost. A gente tá aqui pra te ajudar a colocar sua IA local no ar — e fazer ela conversar de verdade.

Boa sorte, e bem-vindo ao futuro! 🚀