Detección de personas con Frigate y Home Assistant: guía práctica

Convierte tus cámaras locales en un sistema de avisos con detección de personas y grabación continua, sin depender de la nube.

01 El problema: tu cámara avisa por cualquier movimiento

La mayoría de cámaras IP incluyen detección de movimiento por píxeles: cuando algo cambia en la imagen, envían un aviso. El resultado es que recibes alertas por sombras, hojas que se mueven, faros de coches o el gato del vecino. Al final acabas silenciando las notificaciones y la cámara deja de servir para seguridad real.

Lo que necesitas es un filtro que distinga personas del resto de cambios. Frigate es un software libre que procesa el vídeo localmente, detecta objetos (personas, coches, perros, etc.) y te permite grabar solo cuando hay eventos relevantes. Se integra con Home Assistant y no manda nada a la nube. En esta guía te explico cómo montarlo sobre cámaras que ya tengas integradas en Home Assistant.

02 Qué necesitas y qué no debes tocar

Para que Frigate funcione bien necesitas un equipo que ejecute Home Assistant con cierta capacidad de proceso. Si tu Home Assistant corre en un mini PC con CPU Intel (por ejemplo un N100 o similar), puedes usar OpenVINO y no necesitas hardware adicional. Si usas una Raspberry Pi 4, la detección de personas en tiempo real exige un acelerador Google Coral USB, que cuesta entre 70 y 90 €. Con una Raspberry Pi 3 o inferior no te lo recomiendo: el procesado se queda corto y los avisos llegarán tarde.

Las cámaras deben ofrecer un flujo RTSP accesible desde la red local. No hace falta que tengan detección propia ni que estén conectadas a la nube del fabricante; de hecho, es mejor que no lo estén para no depender de servicios externos.

No debes abrir la cámara ni modificar su firmware. Tampoco toques el cableado eléctrico ni pases cable de red por zonas donde haya tensión. Si necesitas una instalación nueva de cable o de alimentación PoE, llama a un técnico cualificado. Trabajar con electricidad sin saber es peligroso y puede dañar el equipo.

03 Instalar Frigate y MQTT en Home Assistant

Frigate se comunica con Home Assistant a través de MQTT. Si aún no tienes un broker MQTT, instala el add-on Mosquitto desde la tienda de add-ons. Crea un usuario y contraseña específicos para Frigate en la configuración de Mosquitto.

Después añade el repositorio de Frigate a Home Assistant: ve a Ajustes > Complementos > Tienda de complementos, pulsa el menú de tres puntos y elige Repositorios. Añade la URL https://github.com/blakeblackshear/frigate-hass-addons. Luego instala el add-on Frigate y ábrelo. La primera vez tardará un poco en arrancar.

La configuración de Frigate se hace en un archivo YAML. Aquí tienes una base para una cámara de entrada con detección de personas, grabación y snapshots:

mqtt:
  host: core-mosquitto
  user: mqtt-user
  password: mqtt-password

cameras:
  entrada:
    ffmpeg:
      inputs:
        - path: rtsp://usuario:contraseña@ip-camara:554/stream1
          roles:
            - detect
            - record
    detect:
      width: 1280
      height: 720
      fps: 5
    objects:
      track:
        - person
    snapshots:
      enabled: true
    record:
      enabled: true
      retain:
        days: 7
        mode: motion
      events:
        retain:
          default: 14
          mode: active_objects

04 Integrar Frigate con Home Assistant y crear la automatización

Una vez Frigate arranque, verás en Home Assistant nuevas entidades gracias al descubrimiento MQTT. Para cada cámara tendrás un sensor binario como binary_sensor.entrada_person_occupancy, que se activa cuando hay una persona en la imagen. También tendrás la cámara camera.entrada y contadores de objetos.

Con esto ya puedes crear una automatización que te avise al móvil cuando se detecte una persona. Necesitas tener configurada la app de Home Assistant en el teléfono para recibir notificaciones. La automatización puede incluir una imagen de la detección:

alias: Aviso persona en entrada
triggers:
  - trigger: state
    entity_id: binary_sensor.entrada_person_occupancy
    to: "on"
actions:
  - action: notify.mobile_app_telefono
    data:
      title: "Persona detectada en entrada"
      message: "Se ha detectado una persona a las {{ now().strftime('%H:%M') }}"
      data:
        image: /api/frigate/notifications/{{trigger.entity_id}}/snapshot.jpg?bbox=1

05 Afinar la detección: zonas, máscaras y umbrales

Para no recibir avisos por personas que pasan por la acera o por zonas que no te interesan, define zonas de detección. Las zonas te permiten vigilar solo una puerta, una ventana o el camino de entrada. También puedes aplicar máscaras para ignorar árboles que se mueven o la calle.

El umbral de confianza (min_score) evita falsos positivos: si Frigate no está seguro de que sea una persona, no te avisa. Ajusta estos valores poco a poco. Aquí tienes un ejemplo con una zona para la puerta y una máscara para la parte superior de la imagen:

cameras:
  entrada:
    zones:
      puerta:
        coordinates: 0.5,1,1,1,1,0.5,0.5,0.5
        objects:
          - person
    motion:
      mask:
        - 0,0,0.2,0,0.2,0.2,0,0.2
    objects:
      track:
        - person
      filters:
        person:
          min_score: 0.65
          threshold: 0.8

06 Cuándo compensa Frigate o si te sobra con un sensor PIR

Frigate no es la única opción para detectar presencia. Si solo quieres saber cuándo alguien cruza una puerta, un sensor de movimiento PIR (o un contacto magnético) puede ser suficiente y te costará menos de 20 €. No tendrás imagen, pero para encender una luz o disparar una sirena puede valer.

Frigate compensa cuando necesitas verificación visual: quieres ver quién ha entrado, recibir una foto en el móvil y revisar la grabación de los últimos días. También es útil si tienes mascotas o falsos positivos constantes con la detección de movimiento clásica. No sustituye a un sistema de alarma certificado si tu seguro lo exige; en ese caso, contacta con un instalador profesional.

Si ya tienes cámaras locales en Home Assistant y un mini PC con CPU Intel, añadir Frigate es prácticamente gratis y te da un salto de calidad. Si usas Raspberry Pi, valora si el coste del Coral USB merece la pena frente a un simple sensor PIR.

Preguntas frecuentes

¿Necesito una Google Coral para usar Frigate?

No siempre. Si tu Home Assistant corre en un mini PC con CPU Intel compatible con OpenVINO, puedes usar el procesador sin hardware adicional. En una Raspberry Pi 4 sí necesitas una Coral USB para detección en tiempo real. En una Raspberry Pi 3 o inferior no te lo recomiendo.

¿Frigate graba continuamente o solo eventos?

Puedes configurarlo de ambas formas. Por defecto graba continuamente y guarda los eventos por separado. La retención se define en días. Si el almacenamiento es limitado, puedes grabar solo eventos o reducir la calidad del flujo de grabación.

¿Puedo usar Frigate con cámaras WiFi baratas?

Si la cámara ofrece un flujo RTSP estable, sí. Pero las cámaras WiFi muy baratas suelen perder conexión o tener artefactos en la imagen, lo que empeora la detección. Para seguridad, es preferible una cámara cableada o, al menos, una con buena cobertura WiFi y flujo RTSP fiable.