Pular para o conteúdo principal
PromptQuorumFeito para humanos. Estruturado para IA.
Início/LLMs locais avançados
Local AI Agents & Tool Use

Análise do Home Generative Agent: agente de IA para o Home Assistant

·6 min de leituraPor Hans Kuepper · Fundador do PromptQuorum · Mecanismo de descoberta de IA de pesos abertos e código aberto

O Home Generative Agent (versão 3.44.10, lançada em 23 de outubro de 2026) é uma integração gratuita do Home Assistant, com licença MIT, que adiciona um agente LLM ao Assist e funciona com um servidor Ollama local ou com modelos na nuvem. Ele precisa de um Home Assistant em execução, de um banco de dados PostgreSQL com pgvector e de pelo menos um provedor de modelos.

Principais conclusões

  • Manutenção: a última versão estável, a 3.44.10, é de 23 de outubro de 2026 e o ramo principal foi atualizado em 1º de novembro de 2026, então não se aplica nenhum aviso de projeto abandonado.
  • Modelo: nenhum vem incluído; há suporte a Ollama, servidores compatíveis com OpenAI, OpenAI, Gemini e Anthropic.
  • Custo: o software é gratuito sob a licença MIT; só um provedor na nuvem, se você escolher um, cobra de você.
  • Instalação: várias etapas entre um app de banco de dados, o HACS e um provedor de modelos, em vez de um único instalador.
  • Autoria: um único desenvolvedor (usuário do GitHub goruck), não uma empresa.

📍 Em uma frase

O Home Generative Agent é um agente de IA de código aberto para o Home Assistant que permite conversar com a casa, criar automações em linguagem natural e perguntar sobre imagens de câmeras.

💬 Em termos simples

Você o instala pelo HACS no seu Home Assistant atual, conecta um modelo de linguagem, como um servidor Ollama local, e depois o escolhe como agente de conversa no Assist.

📌Nota: Esta análise se baseia no repositório do GitHub, na documentação e no tópico da comunidade do Home Assistant, consultados em 1º de novembro de 2026. A PromptQuorum não instalou, executou nem mediu o Home Generative Agent, então confiabilidade, velocidade e qualidade das automações que ele escreve não foram avaliadas.

O Home Generative Agent (HGA) é uma integração personalizada do Home Assistant, gratuita e com licença MIT, que adiciona à interface de conversa Assist um agente de IA com ferramentas. Construído sobre o LangGraph, ele pode controlar os dispositivos que você expõe a ele, escrever automações a partir de pedidos em linguagem natural, descrever imagens de câmeras e manter uma memória de longo prazo. Ele usa o provedor de modelos que você escolher, de um servidor Ollama local até OpenAI, Gemini ou Anthropic. Esta análise se baseia no repositório do GitHub do projeto, no tópico da comunidade do Home Assistant e nas GitHub Releases; a PromptQuorum não o instalou nem o executou. Ele consta no diretório da PromptQuorum.

Análise do Home Generative Agent: agente de IA para o Home Assistant

O que é o Home Generative Agent?

O Home Generative Agent é um agente de IA para o Home Assistant que age sobre a sua casa em vez de apenas repassar suas palavras a um modelo de linguagem. Segundo o README, ele é construído sobre o LangGraph e usa ferramentas para controlar entidades, consultar o histórico, vigiar câmeras e escrever automações reais.

É uma integração personalizada do Home Assistant instalada pelo HACS, não um app independente. O mecanismo Sentinel vigia problemas de segurança com regras fixas, e o README diz que ali o modelo de linguagem apenas aconselha e nunca aciona nada; essa é a descrição do desenvolvedor e não foi verificada. A primeira postagem do tópico da comunidade ainda cita uma versão mais antiga que a do GitHub, por isso esta análise segue o GitHub.

Como obter

O Home Generative Agent é instalado pelo HACS em um Home Assistant existente; não há download independente.

Opção
Como obter
HACS (recomendado)Procure no HACS, que o lista em seu repositório padrão, ou use o botão «Open in HACS» do README; depois reinicie o Home Assistant e adicione a integração
Instalação manualBaixe home_generative_agent.zip nas GitHub Releases e copie para o Home Assistant como descreve o guia de instalação
Banco de dadosO app PostgreSQL com pgvector no Home Assistant OS ou Supervised, ou o seu próprio servidor PostgreSQL
SiteTópico da comunidade do Home Assistant, a página inicial do projeto no GitHub
DocumentaçãoGuias no repositório: instalação, configuração, Sentinel, câmeras e arquitetura
Política de privacidadeNão encontrada no repositório nem no tópico da comunidade
Código-fontegithub.com/goruck/home-generative-agent, licença MIT

Versão analisada: 3.44.10, lançada em 23 de outubro de 2026 segundo as GitHub Releases; também existe uma pré-versão, a 3.45.0-beta.5, que não foi analisada. As etapas do Home Assistant são feitas na interface web dele, mas baixar modelos do Ollama exige um terminal, e toda a cadeia de serviços dá mais trabalho do que uma instalação única.

Requisitos

São necessários o Home Assistant 2026.8.0 ou mais recente, o HACS, um banco de dados PostgreSQL com pgvector e pelo menos um provedor de modelos.

Home Assistant

O que as fontes dizem:
2026.8.0 é o mínimo (a partir do HGA 3.43.3); 2026.9 e 2026.10 constam como compatíveis

Banco de dados

O que as fontes dizem:
PostgreSQL com pgvector; sem ele só funciona o armazenamento em memória, então memória de longo prazo, reconhecimento facial e o detector de anomalias de referência ficam indisponíveis

Provedor de modelos

O que as fontes dizem:
OpenAI, Gemini, Anthropic, Ollama ou qualquer servidor compatível com OpenAI

Modelos locais (opcional)

O que as fontes dizem:
O guia lista modelos do Ollama como gpt-oss, qwen3:8b e qwen3-vl:8b; não indica mínimo de RAM nem de VRAM

Reconhecimento facial (opcional)

O que as fontes dizem:
Um serviço de rostos externo que você configura separadamente

Voz (opcional)

O que as fontes dizem:
As APIs de voz da OpenAI ou um servidor local compatível com OpenAI, como o Speaches; cerca de 2 GB de VRAM são recomendados para o modelo grande do faster-whisper

Qual hardware serve para qual modelo não é informado além disso; depende do servidor de modelos, não do Home Generative Agent.

Como começar

As etapas seguem o README e o guia de instalação; a PromptQuorum não as executou.

  1. 1
    Configure o banco de dados
    Why it matters: Instale o app PostgreSQL com pgvector no Home Assistant OS ou Supervised, ou aponte a integração para o seu próprio servidor PostgreSQL.
  2. 2
    Instale pelo HACS e reinicie
    Why it matters: Instale o Home Generative Agent pelo HACS, reinicie o Home Assistant e adicione a integração em Configurações → Dispositivos e serviços.
  3. 3
    Adicione um provedor de modelos
    Why it matters: Clique em + Model Provider e escolha Edge (Ollama ou um servidor compatível com OpenAI) ou Cloud (OpenAI, Gemini ou Anthropic).
  4. 4
    Execute o Setup
    Why it matters: Clique em + Setup e escolha Basic, que ativa todos os recursos com padrões recomendados, ou Advanced para configurar cada um.
  5. 5
    Escolha-o como agente de conversa
    Why it matters: Selecione o Home Generative Agent em Configurações → Assistentes de voz e depois exponha as entidades que ele deve enxergar.

Recursos confirmados pelas fontes

Tudo abaixo vem do README ou da documentação; nada foi testado aqui.

  • Conversa. Controle e perguntas de status em linguagem natural para as entidades expostas, com respostas em streaming.
  • Automações. Escreve e registra automações a partir do chat; IDs de entidades e chamadas de serviço são verificados antes no Home Assistant, e um PIN opcional de ações críticas retém automações que destrancariam uma porta ou abririam uma garagem.
  • Câmeras. Descreve imagens de câmeras e executa análises acionadas por movimento; o README cita Axis, Ring via ring-mqtt, Reolink e UniFi Protect, além de qualquer câmera que exponha uma entidade de movimento.
  • Sentinel. Detecção de anomalias baseada em regras e uma auditoria de segurança da instalação do Home Assistant, com alertas no celular e triagem opcional pelo modelo de linguagem.
  • Memória e ferramentas. Memória semântica de longo prazo no pgvector e ferramentas extras, como busca na web, por servidores MCP ou por uma API LLM do Home Assistant.
  • Voz. Provedores próprios de voz para texto e de texto para voz para pipelines do Assist, com a OpenAI ou um servidor local.

Fluxo de dados e privacidade

Para onde vão seus dados depende do provedor de modelos que você escolher: o README diz que o Home Generative Agent pode rodar totalmente localmente com Ollama ou um servidor compatível com OpenAI, tendo os provedores na nuvem como alternativa.

Com um provedor na nuvem, seus prompts e as imagens de câmeras que você pede para analisar chegam a esse provedor sob a política dele. O README acrescenta que o Sentinel e a ferramenta de auditoria ocultam endereços MAC e IP e nomes de host de clientes antes de mostrar algo a um modelo de linguagem. O reconhecimento facial usa um serviço de rostos separado, cujo armazenamento esta análise não examinou.

📌Nota: São declarações do desenvolvedor, não resultados de auditoria. A PromptQuorum não inspecionou o código nem o tráfego de rede.

Para quem é indicado

  • Usuários do Home Assistant com uma máquina com GPU sobrando que querem um agente conversacional que fique na própria rede por meio do Ollama.
  • Quem quer ter automações rascunhadas a partir de pedidos em linguagem natural e vai revisar cada uma no editor de automações.
  • Donos de câmeras compatíveis que querem perguntar o que uma câmera está vendo, usando um modelo de visão hospedado por eles.

O que não conseguimos verificar

  • Confiabilidade. Não foi testada a frequência com que o agente encontra a entidade certa ou escreve uma automação correta.
  • Declarações de segurança. O PIN de ações críticas e a afirmação de que o modelo nunca aciona nada no Sentinel são descrições do desenvolvedor.
  • Qualidade dos modelos locais. O guia recomenda modelos, mas não publica benchmarks de uso de ferramentas nem de visão em hardware local.
  • Tratamento de dados. O serviço de rostos e os fluxos de dados para provedores na nuvem não foram inspecionados.

Concorrentes e alternativas

Home Assistant Assist

Plataformas:
Home Assistant (web, Android, iOS)
Preço / licença:
Grátis / Apache-2.0
Diferença principal:
Pipeline de voz integrado; agentes LLM são complementos opcionais
Artigos sobre Home Assistant Assist (1)

nanobot

Plataformas:
Windows, macOS, Linux
Preço / licença:
Grátis / MIT
Diferença principal:
Agente geral auto-hospedado, sem vínculo com o Home Assistant
Artigos sobre nanobot (5)

PicoClaw

Plataformas:
Linux, macOS, Windows, Android
Preço / licença:
Grátis / MIT
Diferença principal:
Agente pequeno de uso geral, sem vínculo com o Home Assistant
Artigos sobre PicoClaw (1)

Somente o Home Assistant Assist está no mesmo segmento de casa inteligente; nanobot e PicoClaw são agentes gerais. Confirme o preço, a licença e as plataformas atuais de cada app na página dele antes de escolher.

Comparar no diretório

Perguntas frequentes

O Home Generative Agent substitui o Home Assistant Assist?

Não. Você o seleciona como agente de conversa dentro do Assist, e ele pode adicionar a um pipeline do Assist seus próprios provedores de voz para texto e de texto para voz.

Por que o agente diz que não encontra um dispositivo?

Ele só enxerga as entidades expostas ao Assist e as encontra por nome e área, então o README recomenda expor a entidade e dar a ela um nome e uma área claros.

Funciona no Home Assistant Container ou Core?

O app de banco de dados incluído exige o Home Assistant OS ou Supervised; no Container ou Core, o guia de instalação indica o seu próprio servidor PostgreSQL com pgvector.

Veredito

O Home Generative Agent é um jeito gratuito e com licença MIT de dar a um Home Assistant existente um agente de IA com ferramentas, que pode rodar com um servidor Ollama local ou um modelo na nuvem, e ele é mantido ativamente. Em contrapartida, a instalação envolve vários serviços, muitos recursos dependem de componentes opcionais como o serviço de rostos, e a PromptQuorum não testou a confiabilidade, o comportamento de privacidade nem a qualidade dos modelos locais. Ele serve para usuários do Home Assistant à vontade com o HACS e um servidor de modelos; quem o usar para fechaduras ou automações de segurança deve conferir por conta própria cada automação gerada.

Fontes

← Voltar para LLMs locais avançados

MCP