Principais conclusões
- O Home Assistant traz uma integração oficial do Ollama — sem necessidade de add-on personalizado
- Rode o Ollama no host do Home Assistant ou em outra máquina da sua LAN
- Adicionar integração → inserir a URL do Ollama (padrão http://host:11434) → selecionar um modelo
- Exponha só as entidades que o modelo deve controlar, depois defina-o como o agente do Assist
- Use um modelo pequeno com chamada de funções para baixa latência; link externo para profundidade de modelo/hardware
- Tudo é local: nenhum comando ou estado do lar sai da sua rede
O que conectar o Ollama ao Home Assistant lhe dá
Dá ao Home Assistant um agente de conversa local: você fala ou digita uma solicitação e o modelo a mapeia para ações de dispositivo, sem um assistente na nuvem no meio. Isso substitui o agente de voz na nuvem (Alexa, Google) para o controle em linguagem natural.
- Controle em linguagem natural: "desligue tudo lá embaixo" mapeia para as entidades certas em vez de uma frase fixa.
- Local e privado: o modelo roda via Ollama no seu hardware — veja o guia da casa inteligente com LLM local para a arquitetura completa.
- Pronto para voz: combine-o com um pipeline de voz local para um substituto privado da Alexa — veja montar um assistente de voz totalmente local.
Pré-requisitos antes de começar
Você precisa do Home Assistant rodando, do Ollama rodando em um host alcançável e de um modelo baixado. Este guia não reexplica a instalação do Ollama — link externo para isso.
- 1Home Assistant ativo e alcançável na sua LAN.
- 2Ollama instalado e rodando no mesmo host ou em outra máquina — veja como instalar o Ollama.
- 3Pelo menos um modelo baixado (um modelo de instruções pequeno é o ponto de partida adequado).
- 4Alcançabilidade de rede: confirme que o Home Assistant consegue alcançar a URL do Ollama (porta padrão 11434).
Como você adiciona a integração do Ollama?
No Home Assistant, vá em Configurações → Dispositivos e serviços → Adicionar integração → Ollama, depois insira a URL do Ollama. A URL padrão é http://<host>:11434.
| Passo | Ação | Resultado |
|---|---|---|
| 1 | Configurações → Dispositivos e serviços → Adicionar integração | O seletor de integrações abre |
| 2 | Busque "Ollama" e selecione | A caixa de diálogo de conexão aparece |
| 3 | Insira a URL do Ollama (http://host:11434) | O Home Assistant se conecta ao Ollama |
| 4 | Selecione um modelo da lista | Uma entidade de conversa é criada |
Qual modelo você deve escolher?
Escolha um modelo pequeno, rápido, que siga instruções, com chamada de funções para o controle do lar — não o maior modelo que você consiga rodar. Aqui a latência importa mais que a capacidade bruta.
- Use um modelo pequeno se quiser respostas ágeis em hardware modesto.
- Priorize o suporte a chamada de funções/ferramentas para que o modelo emita ações de dispositivo de forma confiável.
- Para uma lista curta específica de casa inteligente, veja melhores modelos LLM locais para o controle da casa inteligente.
- Para uma mecânica de modelos mais profunda, link externo para melhores LLMs locais para programar e o cluster local-llms — este guia não reordena modelos.
Configurar o agente de conversa
Defina a entidade de conversa do Ollama como o agente no seu pipeline do Assist e exponha só as entidades que você quer que ele controle. A exposição é o que deixa o modelo agir sobre os dispositivos.
- 1Abra Configurações → Assistentes de voz e edite (ou crie) um pipeline do Assist.
- 2Defina o agente de conversa para a entidade do Ollama criada pela integração.
- 3Na exposição do Assist, exponha as entidades específicas que o modelo pode controlar.
- 4Opcionalmente adicione um prompt personalizado para limitar o tom e o escopo.
- 5Salve, depois teste pela caixa de chat do Assist antes de adicionar voz.
Controlar dispositivos por voz ou texto
Uma vez definido o agente e expostas as entidades, digite ou diga uma solicitação no Assist e o modelo realiza a ação. Mantenha as automações de segurança determinísticas como regras simples, não guiadas pelo modelo.
- Teste primeiro com comandos simples ("acenda a luz do escritório"), depois com frases naturais.
- O modelo só controla as entidades que você expôs — dispositivos não expostos ficam intactos.
- Adicione um front-end de voz local para uso mãos-livres — veja assistente de voz local.
- Para automações conscientes do contexto além de comandos diretos, veja automações de IA com um LLM local.
Solucionar problemas comuns
A maioria dos problemas é de conectividade, escolha de modelo ou exposição. Resolva-os em ordem.
- Não conecta: verifique a URL do Ollama e se a porta 11434 é alcançável pelo Home Assistant; vincule o Ollama a 0.0.0.0 se estiver em outro host.
- Respostas lentas: mude para um modelo menor ou adicione uma GPU/NPU — veja melhor hardware para uma casa inteligente local.
- O modelo ignora os dispositivos: confirme que as entidades estão expostas ao Assist e que a entidade do Ollama é o agente ativo.
- Ações erradas: adicione um prompt de sistema que limite o escopo, ou reduza o número de entidades expostas.
Perguntas frequentes
Qual modelo devo escolher para o Home Assistant?
Um modelo pequeno que siga instruções com suporte a chamada de funções é o melhor ponto de partida, porque o controle do lar precisa de respostas rápidas e estruturadas. O tamanho certo depende do seu hardware; veja o guia dos melhores modelos LLM locais para casa inteligente para opções atuais.
Preciso de uma GPU para rodar o Ollama com o Home Assistant?
Não, mas ajuda. Um modelo pequeno roda em uma CPU moderna ou GPU integrada; uma GPU dedicada ou NPU reduz a latência, deixando o assistente mais ágil. Ajuste o tamanho do modelo ao seu hardware.
O modelo pode controlar qualquer dispositivo no Home Assistant?
Apenas as entidades que você expõe explicitamente ao Assist. A exposição é opt-in, então o modelo não pode agir sobre dispositivos que você não compartilhou, o que mantém o controle previsível e seguro.
A integração do Ollama funciona offline?
Sim. O Ollama roda o modelo localmente e o Home Assistant controla os dispositivos pela sua LAN, então o assistente funciona sem internet. Só o acesso remoto de fora do lar precisa de conectividade.