Você abre uma IA, começa uma conversa e, justo quando precisa continuar, aparece o aviso de limite. A saída mais óbvia é assinar outro serviço. A conta vai crescendo.
No vídeo, mostrei o chat que montei em casa para aproveitar planos grátis de diferentes provedores. Aqui está o passo a passo. No fim, você terá uma tela de chat no computador e poderá abri-la no celular quando os dois estiverem na mesma rede de casa.
O que vamos instalar
São duas peças:
- OmniRoute é o roteador. Você conecta as chaves dos provedores e cria uma sequência de modelos. Se o primeiro ficar indisponível ou atingir um limite, o combo pode tentar o próximo.
- Open WebUI é a tela de chat. Ela funciona no navegador e lembra a interface de outros chats de IA.
O painel do OmniRoute mostrado no vídeo listava 151 provedores com plano grátis. Esse é o número exibido no painel. Não significa que todos ofereçam uma API gratuita, estejam disponíveis no Brasil ou sirvam para este tutorial. Vamos usar chaves de API obtidas nos sites oficiais.
Antes de começar
Você precisa de um computador com Windows, macOS ou Linux compatível com Docker, configurado para executar contêineres Linux. O computador deve ter internet, espaço para baixar os programas e permanecer ligado enquanto você usar o chat. Reserve cerca de 30 a 40 minutos, mas o download pode levar mais tempo conforme sua conexão.
Nunca instalou o Docker? Comece por aqui
O Docker é o programa que vai rodar o OmniRoute e o Open WebUI no seu computador. Escolha o tutorial oficial do seu sistema e conclua a instalação antes de baixar o instalador deste artigo:
- Windows: siga o tutorial de instalação do Docker Desktop para Windows. Baixe o instalador, abra o arquivo e siga as telas. Se ele pedir para ativar o WSL 2 ou reiniciar o computador, faça isso. Depois, abra o Docker Desktop pelo menu Iniciar e espere terminar de carregar. Confirme que está usando Linux containers.
- Mac: siga o tutorial de instalação do Docker Desktop para Mac. Escolha a versão para o chip do seu Mac, Apple Silicon ou Intel. Abra o arquivo
.dmg, arraste o Docker para Aplicativos, inicie o programa e espere terminar de carregar. - Linux: siga o guia de instalação do Docker Engine e escolha sua distribuição. Se você usa Ubuntu, pode ir direto ao tutorial de Ubuntu. Ao terminar, siga a configuração para usar Docker sem
sudo, porque o instalador abaixo executadockercom seu usuário.
Como conferir: no Windows e no Mac, deixe o Docker Desktop aberto. No Linux, abra o terminal e rode docker info. Se aparecer um erro de permissão, resolva-o pelo guia acima antes de continuar. O instalador do próximo passo também verifica se consegue acessar o Docker.
O OmniRoute também pode ser instalado sem Docker. Escolhi Docker aqui porque o mesmo conjunto de serviços funciona nos três sistemas. Os arquivos abaixo instalam e iniciam os dois programas. A criação das contas e das chaves dos provedores é feita depois, nos sites oficiais.
Teste no computador que você já tem. Só faz sentido pensar em outro equipamento depois que souber se vai usar o chat com frequência.
Passo 1: baixe o instalador do seu sistema
Cada arquivo compactado contém um script legível. Extraia o ZIP e escolha somente o script do seu sistema. Guarde o arquivo extraído em um lugar fácil de achar:
Quer ver tudo o que o arquivo vai fazer? Abra o script em um editor de texto antes de executá-lo. Ele verifica se o Docker está funcionando, cria uma rede para os dois programas, baixa as imagens oficiais, inicia os contêineres e gera senhas aleatórias para a instalação. Ele não pede suas chaves dos provedores.
O instalador chama o contêiner do roteador de capyborg-omniroute e o da tela de chat de capyborg-open-webui. Esses são nomes internos do Docker, não o nome do seu computador. Você verá o primeiro no endereço de conexão do passo 5.
Windows
Depois de extrair o ZIP, abra a pasta onde ficou o arquivo. Clique na barra de endereço da pasta, digite powershell e pressione Enter. Na janela que abrir, rode:
.\instalar-chat-ia-windows.cmd
O Docker Desktop precisa estar aberto e em modo Linux containers. A janela ficará aberta no fim para você copiar a senha inicial.
Mac
Depois de extrair o ZIP para a pasta Downloads, abra o Terminal e rode:
bash "$HOME/Downloads/instalar-chat-ia-mac.sh"
Se o script estiver em outra pasta, arraste o arquivo para a janela do Terminal depois de digitar bash e pressione Enter.
Linux
Depois de extrair o ZIP para a pasta Downloads, abra o terminal e rode:
bash "$HOME/Downloads/instalar-chat-ia-linux.sh"
Se o arquivo ficou em uma subpasta, arraste-o para a janela do terminal depois de digitar bash e pressione Enter. Se aparecer erro de permissão do Docker, siga a configuração oficial para uso sem sudo e execute o script novamente. O script não muda as permissões do seu computador.
Guarde a senha inicial do OmniRoute mostrada no terminal. Você vai usá-la no próximo passo. Ao terminar, o instalador mostra dois endereços: http://localhost:20128 para o OmniRoute e http://localhost:3000 para o Open WebUI. O primeiro carregamento pode demorar alguns minutos.
Passo 2: entre no OmniRoute
No computador, abra http://localhost:20128. Entre com a senha inicial que o instalador mostrou. Se o painel oferecer a troca da senha, faça isso e guarde a nova no seu gerenciador de senhas.
O endereço localhost abre só no próprio computador. O instalador restringe a porta do OmniRoute a ele. Essa é uma das razões pelas quais o endereço do OmniRoute no Open WebUI será diferente.
Passo 3: crie as chaves grátis
Uma chave de API funciona como uma senha que permite ao OmniRoute usar sua conta em cada provedor. Crie uma chave em cada serviço e não a coloque em comentários, prints ou mensagens para outras pessoas.
- Google AI Studio: abra a página de chaves, faça login e copie a chave existente ou escolha Create API key. Confira na tabela oficial quais modelos têm faixa gratuita.
- Groq: abra a página de chaves, crie sua conta se necessário e escolha Create API Key. Confira os limites disponíveis no seu painel.
- OpenRouter: crie uma chave na página de API keys. Para este guia, escolha apenas modelos cujo ID termina em
:freena lista oficial.
E Cerebras e Mistral? A Cerebras apresenta crédito inicial gratuito, que não equivale a uma franquia permanente. Só a inclua enquanto sua conta mostrar uso gratuito. A documentação atual da Mistral diz que o acesso à API exige ativar a cobrança. Por isso, Mistral fica fora do combo gratuito deste guia.
Passo 4: conecte as chaves e crie o combo
No OmniRoute, abra Providers → Add Provider. Selecione Google, cole a chave e teste a conexão. Repita com Groq e OpenRouter. O guia oficial de provedores mostra esse fluxo.
Depois, abra Combos → Create New. Dê ao combo o nome gratis, escolha pelo menos dois modelos de provedores diferentes e defina a estratégia Priority. Salve. O OmniRoute tentará os modelos na ordem configurada e poderá recorrer ao próximo quando o anterior não estiver disponível. Veja o guia oficial de combos.
Confira cada modelo antes de adicioná-lo. Um provedor com faixa gratuita também pode oferecer modelos pagos. No OpenRouter, mantenha apenas IDs terminados em :free.
Passo 5: conecte o Open WebUI ao OmniRoute
Abra http://localhost:3000 no computador. Crie sua conta de administrador com uma senha forte. Faça isso antes de abrir o chat no celular, pois a primeira conta criada vira administradora.
No OmniRoute, abra Endpoints e crie ou copie uma chave para a conexão. Use essa chave no Open WebUI. O instalador ativou a exigência de chave, então não serve colocar qualquer texto nesse campo.
De onde saiu capyborg-omniroute? O script do passo 1 criou um contêiner com esse nome e colocou os dois programas na rede Docker capyborg-ia. Dentro do Open WebUI, esse nome encontra o OmniRoute. Você não precisa renomear seu PC nem descobrir o IP dele para esta conexão.
No Open WebUI, abra seu perfil e vá a Settings → Admin → Connections:
- Em Manage OpenAI API Connections, adicione uma conexão do tipo External.
- Em URL, coloque
http://capyborg-omniroute:20128/v1. - Em API Key, cole a chave copiada do OmniRoute.
- Em Advanced → Model IDs, adicione apenas
gratis. - Salve. Se houver uma conexão Ollama ativa e você não a usa, desative-a.
Nessa configuração, 127.0.0.1 apontaria para o próprio contêiner do Open WebUI. O campo Model IDs faz a interface mostrar só o combo escolhido. Veja a documentação do Open WebUI.
Abra um novo chat, selecione gratis e envie: “Me explique em três frases o que é uma chave de API.” Se vier uma resposta, o chat está funcionando.
Passo 6: abra no celular
O celular precisa estar no Wi-Fi da casa. O computador pode estar no mesmo Wi-Fi ou conectado por cabo ao mesmo roteador. Para abrir o chat no celular, você precisa do IP local do computador, um número parecido com 192.168.1.50. Não é o endereço público da sua internet.
- Windows: abra o menu Iniciar, digite
cmde pressione Enter. Na janela preta, digiteipconfige pressione Enter. Procure a seção Adaptador de Rede sem Fio Wi-Fi ou Adaptador Ethernet, conforme sua conexão. Copie o número ao lado de Endereço IPv4. Ignore os adaptadores que começam comvEthernetouDocker. Se preferir, veja o IP em Configurações → Rede e Internet → Propriedades. Ajuda da Microsoft. - Mac: abra Ajustes do Sistema → Rede → Wi-Fi ou Ethernet, escolha a conexão em uso, clique em Detalhes → TCP/IP e copie o Endereço IPv4. Ajuda da Apple.
- Linux: nas configurações da rede em uso, procure IPv4 nos detalhes da conexão. Se preferir o terminal, rode
ip -4 route get 1.1.1.1e copie o número que aparece depois desrc. Por exemplo, se a saída trouxersrc 192.168.1.50, esse é o IP a usar.
Agora, no navegador do celular, substitua IP-DO-SEU-PC pelo número que você copiou: http://IP-DO-SEU-PC:3000. Com o exemplo acima, fica http://192.168.1.50:3000. Digite o endereço completo, incluindo http:// e :3000, e entre com a conta criada no passo 5.
Se a página não abrir, teste primeiro http://localhost:3000 no computador. Depois, confirme que o celular não está na rede de convidados nem usando VPN, e verifique se o firewall do computador permite acesso à porta 3000 na rede de casa.
Como ver a troca funcionando
- Com pelo menos dois provedores funcionando no combo, envie uma pergunta curta pelo Open WebUI.
- No OmniRoute, veja em Logs qual provedor respondeu.
- Em Providers, desative temporariamente a conexão que respondeu.
- Envie outra pergunta curta usando o combo
gratise confira se outro provedor assumiu. - Reative a conexão que você desligou.
Esse teste mostra a troca quando uma opção fica indisponível. Se todos os provedores do combo estiverem sem cota, o chat também para de responder.
Cuidados e limites que você precisa saber
Leia antes de colocar dados reais no chat. A tela roda no seu computador, mas suas perguntas seguem pela internet até o provedor que respondeu.
- São outros modelos. A qualidade varia. Em tarefas difíceis, alguns modelos gratuitos podem entregar respostas piores.
- Privacidade muda de provedor para provedor. O Google informa que o conteúdo da faixa gratuita pode ser usado para melhorar seus produtos. No OpenRouter, as práticas variam conforme o modelo e o provedor final. Não envie senhas, documentos pessoais, dados de clientes ou material confidencial sem verificar as regras de cada serviço.
- A troca automática tem limites. Provedores podem mudar cotas, modelos e condições. Ter três chaves não garante que sempre haverá uma disponível.
- O computador precisa ficar ligado. Se o PC dormir ou o Docker parar, o chat deixa de funcionar.
- Mantenha o acesso na rede de casa. Use senha forte no Open WebUI e não abra a porta 3000 no roteador para a internet. A orientação de segurança do projeto pede proteção adicional para acesso público.
- Use as APIs oficiais. O OmniRoute também lista conexões por login ou sessão de ferramentas de terceiros. Elas podem esbarrar nos termos de uso e causar bloqueios. Neste guia, conectamos somente chaves criadas nos painéis oficiais.
- Este instalador usa a imagem slim do Open WebUI. Ela serve para o chat de texto deste guia. Recursos como voz e processamento de documentos podem exigir serviços ou componentes adicionais. Veja as diferenças entre imagens.
Perguntas frequentes
É seguro usar?
Você controla o acesso à interface com uma senha e mantém o OmniRoute restrito ao computador. Suas perguntas ainda são enviadas aos provedores de IA. Confira a política de dados de cada um antes de usar informações sensíveis.
Funciona no celular com o computador desligado?
Não. Neste guia, o computador hospeda o chat. O celular apenas abre a interface pela rede de casa.
Posso usar no trabalho?
Depende das regras da sua empresa e dos dados enviados. Não coloque informações de clientes ou documentos internos em APIs externas sem autorização.
Quanto custa de luz?
Depende do consumo real do computador e da tarifa da sua região. Para estimar: potência em watts × horas ligado ÷ 1.000 × preço do kWh. Um medidor de tomada ajuda a descobrir o consumo do seu PC.
Preciso cadastrar cartão?
Confira as condições atuais de cada opção gratuita. Não ative cobrança para seguir este tutorial. A Mistral ficou de fora porque sua documentação atual exige ativação de cobrança para a API.
E se eu rodar o instalador de novo?
Ele reconhece os contêineres que já criou e não apaga as configurações. Se você perdeu a senha inicial do OmniRoute, não espere que uma nova execução mostre a senha antiga. Consulte a recuperação de senha na documentação oficial.
Pronto para conversar
Agora é só abrir o Open WebUI, escolher gratis e usar. Se uma resposta falhar, olhe primeiro os limites e o estado dos provedores no OmniRoute. É ali que você descobre qual peça parou.
Transparência: conheço o criador do OmniRoute. Este artigo não é publicidade paga e não recebi benefício para publicá-lo.
