BirdLense Hub — обзор проекта
BirdLense Hub — открытое ПО для умной кормушки и наблюдения за садом: детекция птиц (и белок) на видео, классификация видов локальным ML, запись роликов и таймлайн, которым владеете вы.
Зачем это нужно
- Приватность: основная обработка на вашем железе (Docker), без облака вендора для распознавания.
- Совместимость: Go2RTC для потоков, по желанию Frigate + Bird Classification, BirdNET по MQTT, Home Assistant, Telegram.
- Citizen science: экспорт в eBird и iNaturalist, сравнение с регионом, датасеты для дообучения.
Кому подойдёт
| Аудитория | С чего начать |
|---|---|
| Дом / любитель природы | INSTALL → SCENARIOS |
| Пользователь Frigate / HA | SCENARIOS, CONFIGURATION |
| Разработчик / контрибьютор | LOCAL_DEV, Contributing, ARCHITECTURE |
| Автор статей / лендинга | Эта страница + FEATURES |
Что где крутится
- Один контейнер: nginx, веб-API (Flask), опционально MCP и processor (видео, YOLO, ByteTrack, FFmpeg, MQTT).
- Снаружи: Go2RTC (желательно), MQTT, опционально Frigate, BirdNET-Pi/Go, ESPHome/Tasmota.
Схема и потоки данных: ARCHITECTURE.
Как устроено распознавание
- Детектор + классификатор (YOLO): птица/белка в кадре, затем вид. По умолчанию EU-модель (~491 вид); веса US — в TRAINING.
- Frigate может отдавать Bird Classification (
sub_label); результаты сливаются с видео-ML. - BirdNET — слияние по времени при настроенном MQTT.
Карта документации
| Задача | Документ |
|---|---|
| Установка и деплой | INSTALL |
| Сценарии «как настроить X» | SCENARIOS |
| Все параметры | CONFIGURATION |
| Термины | GLOSSARY |
| Список возможностей | FEATURES |
| Проблемы | TROUBLESHOOTING |
| Тесты и проверка после деплоя | TESTING |
| Полный индекс | docs/README |
| Карта разделов для сайта | SITE_MAP |
OpenAPI: спецификация YAML.
Сайт и статьи на базе репозитория
Этот файл — сюжет «что и зачем»; INSTALL + SCENARIOS — быстрый старт; FEATURES — витрина возможностей; ARCHITECTURE — техника. Правила оформления: Documentation. Локализация: I18N_STATUS.
Версия
Актуальная линейка релизов: бейдж в корневом README и Changelog.