Guia completo para integrar o Frigate ao Home Assistant

Última atualização: 02/07/2026

  • O Frigate utiliza inteligência artificial local para detectar objetos e pessoas sem depender da nuvem.
  • A integração requer um broker MQTT para comunicar os eventos detectados com o Home Assistant.
  • É compatível com diversos hardwares, desde Raspberry Pi e Google Corel até servidores Docker e Synology NAS.
  • Permite criar automações avançadas com base na contagem de objetos detectados em tempo real.

Como usar o Frigate com o Home Assistant

¿Como usar o Frigate com o Home Assistant? Se você gosta de automação residencial e já tem o Home Assistant configurado, provavelmente já percebeu que gerenciar câmeras pode ser uma verdadeira dor de cabeça. Muitos sistemas genéricos apenas alertam quando "algo se moveu", mas A fragata muda as regras do jogo. Ao integrar inteligência artificial, é possível saber exatamente se o que entrou no jardim é um gato, um carro ou um intruso, enviando capturas precisas no momento exato.

A melhor parte é que se trata de um software de código aberto que roda localmente. Esqueça as assinaturas mensais de serviços de nuvem duvidosos; aqui está a solução ideal. Você tem controle total sobre seus dados. e a privacidade da sua casa. Dito isso, prepare-se para fazer alguns ajustes, pois mesmo que você não seja um programador experiente, precisará modificar alguns arquivos de configuração para que tudo funcione perfeitamente.

automação residencial
Artigo relacionado:
Gadgets de automação residencial: o guia definitivo para os melhores dispositivos inteligentes para casa em 2024

O que é uma fragata e como funciona o seu hardware?

Basicamente, o Frigate é um NVR (Gravador de Vídeo em Rede) que analisa fluxos de vídeo em tempo real. Para evitar que ele sobrecarregue a CPU do seu computador, é altamente recomendável usar um... acelerador de hardware como o Google Coral USBCoral é uma TPU projetada especificamente para essas tarefas de IA. Se você estiver usando um Raspberry Pi 4, por exemplo, o Coral é praticamente essencial para executar várias câmeras sem que o sistema trave.

Conteúdo exclusivo - Clique aqui  Como instalar o CUDA no Windows sem erros: um guia para desenvolvedores e criadores

Dependendo de onde você o instalar, as opções variam. Você pode executá-lo em um Contêiner Docker no Debian (a opção mais estável), em uma máquina virtual Proxmox ou até mesmo como um complemento dentro do próprio sistema operacional Home Assistant (HAOS). Se você escolher Dispositivos NAS como Synology ou QNAPLembre-se de que você precisa atribuir altos privilégios e ajustar a memória compartilhada (shm-size) para evitar erros de barramento ao processar imagens de alta resolução.

Qual NAS comprar com base no número de usuários?
Artigo relacionado:
Qual NAS comprar com base no número de usuários e em como você o utilizará?

Instalação passo a passo no Home Assistant

Como conectar o Home Assistant com o NTFi

Para quem usa HAOS e busca uma solução prática, o caminho mais simples é através de HACS (Loja Comunitária do Home Assistant)Primeiro, você precisa instalar o HACS, caso ainda não o tenha. Em seguida, procure pela integração com a fragata e faça o download. Isso é essencial. Reiniciar o Home Assistant Após a instalação, as alterações entrarão em vigor.

Uma área que proporciona um impulso motivacional para muitas pessoas é o MQTT. A Frigate precisa de um broker MQTT (como o Mosquitto) para se comunicar com o Home Assistant. Você precisa instalar o complemento Mosquitto e configurá-lo na seção Dispositivos e Serviços. Certifique-se de que... criar um usuário dedicado Para MQTT, já que essas credenciais serão as mesmas que você inserirá no arquivo de configuração do Frigate para que eles se reconheçam.

Conteúdo exclusivo - Clique aqui  ChatGPT para Mac estreia integração em nuvem e novos recursos avançados

Configurando o arquivo frigate.yml

É aqui que a mágica acontece e onde geralmente começam os problemas com arquivos .yaml ou .yml. O primeiro passo é instalar um editor de código, como o Servidor Studio Codepara criar o arquivo frigate.yamlNeste documento, você definirá o endereço IP do seu broker MQTT e os detalhes da sua câmera. Para câmeras, é melhor usar o fluxo RTSP; normalmente, o O subtipo 0 é para gravação. (alta qualidade) e o subtipo 1 para detecção (Resolução mais baixa para economizar CPU).

Como usar o Home Assistant como uma ponte entre dispositivos incompatíveis
Artigo relacionado:
Como usar o Home Assistant como uma ponte entre dispositivos incompatíveis

Um exemplo de configuração envolve definir a largura, a altura e o FPS (entre 5 e 10 geralmente é suficiente). Você também pode especificar quais objetos deseja rastrear, como... "pessoa", "carro" ou "cachorro"Se você perceber que há muitos falsos positivos porque um galho ou árvore está se movendo, você pode desenhar máscaras de área Na interface da fragata, para instruir o sistema a ignorar essas áreas específicas.

Integração final e automação

Instale o Home Assistant no Raspberry Pi

Assim que o contêiner Frigate estiver em execução e o arquivo de configuração estiver correto, acesse: Configurações > Dispositivos e serviços No Home Assistant, adicione a integração do Frigate. Será solicitada a URL da instância (por exemplo, a porta 5000 para acesso interno ou 8971 se estiver usando autenticação). Se tudo correr bem, todas as suas câmeras aparecerão como entidades no Home Assistant.

Conteúdo exclusivo - Clique aqui  Como configurar o Syncthing e tirar o máximo proveito dele

Agora vem a parte divertida: automações. Você pode criar uma regra para que, quando o O sensor de contagem de pessoas é maior que 0.A luz do corredor pode acender ou você pode receber um alerta no Telegram. Para notificações do Telegram, você pode usar um serviço que envia o instantâneo do evento detectado e um link direto para o videoclipe, permitindo que você saiba o que está acontecendo em casa sem precisar abrir o aplicativo. aplicativo de videovigilância.

Como saber se sua câmera IP está sendo espionada
Artigo relacionado:
Como saber se sua câmera IP e seus dispositivos estão sendo espionados

Considerações técnicas e otimização

Se você estiver enfrentando erros de conexão, verifique se a porta 5000 está aberta no seu firewall e se o URL está correto. Em ambientes Docker, a configuração do memória compartilhada (/dev/shm)A regra geral é calcular o espaço com base na resolução das suas câmeras para evitar que o processo pare abruptamente. Se você estiver usando hardware específico como Hailo-8 ou Rockchip, lembre-se de usar o imagens Docker otimizadas (com sufixos como -rk ou -synaptics) para aproveitar a aceleração de hardware.

Ter um sistema de vigilância robusto envolve equilibrar a qualidade da gravação com o consumo de recursos. Ao separar o Frigate em seu próprio contêiner ou máquina, você evita o processamento de imagens. afetar o desempenho geral da sua casa inteligente, permitindo que luzes e sensores respondam instantaneamente enquanto a IA analisa cada quadro das suas câmeras IP.

Xiaomi Smart Camera 3 3K
Artigo relacionado:
Xiaomi Smart Camera 3 3K: a nova câmera de vigilância 3K que pretende conquistar a casa conectada.