explaingit

chasem12345/hass-aviary

Analysis updated 2026-05-18

2PythonAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

A Home Assistant add-on that collects bird detections from Frigate NVR and BirdNET-Go via MQTT and shows them in a single searchable dashboard.

Mindmap

mindmap
  root((HASS-Aviary))
    What it does
      Aggregates bird detections
      MQTT subscriber
      SQLite storage
    Data Sources
      Frigate NVR visual
      BirdNET-Go audio
    Dashboard Features
      Recent detections feed
      Per-species pages
      Day-grouped browsing
    Tech Stack
      Python
      FastAPI
      Home Assistant
      SQLite
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Track which bird species visit your yard by combining camera and audio detection data in one Home Assistant dashboard.

USE CASE 2

Browse historical bird activity charts and per-species sighting counts from your home NVR setup.

USE CASE 3

Watch video clips or listen to audio recordings of specific bird detections directly inside Home Assistant.

What is it built with?

PythonFastAPIHome AssistantSQLiteMQTT

How does it compare?

chasem12345/hass-aviary0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/52/54/5
Audienceops devopsgeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Frigate NVR and BirdNET-Go already running, plus a Home Assistant instance with MQTT broker.

In plain English

Aviary is a Home Assistant add-on that collects bird detections from two separate systems and displays them in a single dashboard inside your Home Assistant setup. It connects to Frigate NVR, which uses a camera to identify birds visually, and BirdNET-Go, which identifies birds by their calls using audio. Both systems publish their detection results to MQTT, a messaging protocol common in home automation. Aviary subscribes to those messages and stores every detection in a local SQLite database. It does not do any bird identification itself, it only aggregates results from the two sources that already do that work. The dashboard appears as a sidebar entry in Home Assistant on both desktop and mobile. You can browse recent detections, view a live-refreshing feed, and click into individual species pages that show totals, first and last sightings, and activity charts. When you open a detection from Frigate, it plays the video clip or snapshot. When you open a detection from BirdNET-Go, it plays the audio recording with a spectrogram. Detections can be filtered by day and are paginated for long lists. Installation works through the standard Home Assistant add-on store. You add the repository URL, find Aviary in the store, and install it. The configuration tab asks for the URLs of your Frigate and BirdNET-Go instances and lets you override MQTT settings if you are not using the default Mosquitto broker. Once started, the add-on can also backfill existing detections from both sources on startup. The project is new, created in July 2026, and appears aimed at birding enthusiasts who already run Frigate and BirdNET-Go at home.

Copy-paste prompts

Prompt 1
I have Frigate NVR and BirdNET-Go running at home. How do I install HASS-Aviary as a Home Assistant add-on and connect it to both sources via MQTT?
Prompt 2
My Aviary dashboard is not showing detections. Walk me through checking the MQTT topic settings for Frigate and BirdNET-Go.
Prompt 3
How does HASS-Aviary store bird detection data? What does the SQLite schema look like and how can I query it directly?
Prompt 4
I want to run HASS-Aviary locally for development without a full Home Assistant install. What does aviary/DOCS.md say about the local-dev setup?

Frequently asked questions

What is hass-aviary?

A Home Assistant add-on that collects bird detections from Frigate NVR and BirdNET-Go via MQTT and shows them in a single searchable dashboard.

What language is hass-aviary written in?

Mainly Python. The stack also includes Python, FastAPI, Home Assistant.

How hard is hass-aviary to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hass-aviary for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub chasem12345 on gitmyhub

Verify against the repo before relying on details.