Vogelalbum 1.0.0

Eine Kamera am Vogelhaus, ein Rechner der erkennt wer da war — und eine
Sammlung, die sich von allein fuellt.

Zwei neuronale Netze: eines findet den Vogel im Bild, eines bestimmt die
Art. 148 heimische Arten, auf Deutschland eingeschraenkt und neu normiert —
ohne diese Einschraenkung wird aus einer Kohlmeise eine nordamerikanische
Schwesterart. Daraus entsteht ein Sammelalbum: nummerierte Seiten,
gefundene Arten in Farbe, fehlende als Schatten, dazu Erstfang, Punkte,
Stufen und 15 Abzeichen.

Laeuft vollstaendig auf eigener Hardware. Kein Cloud-Dienst, kein Konto,
keine Telemetrie; die Bilder verlassen das eigene Netz nicht.

Zwei getrennt deploybare Teile: die Sammlung als Django-Anwendung, die
Erkennung als eigener Dienst. Der Erkennungs-Dienst fragt selbst an und
braucht deshalb weder eine erreichbare Adresse noch einen offenen Port —
er laeuft hinter einem gewoehnlichen Router.

Dabei: Firmware fuer Raspberry Pi und ESP32-S3, Anbindung an Home
Assistant ueber MQTT, Oberflaeche auf Deutsch und Englisch, Einstellungen
je Kamera aus dem Browser, und ein Weg fuer Fotos von unterwegs.

AGPL-3.0.

.gitea/ISSUE_TEMPLATE/falsch-bestimmt.md

@@ -0,0 +1,48 @@
+---
+name: "🐦 Art falsch bestimmt"
+about: "Der Vogel war ein anderer, als Vogelalbum sagt"
+title: ""
+labels:
+  - erkennung
+---
+
+<!--
+Das ist die nützlichste Rückmeldung, die dieses Projekt bekommen kann: Das
+Modell ist nordamerikanisch trainiert, und welche heimischen Arten es
+verwechselt, lässt sich nur im Garten herausfinden.
+-->
+
+## Welche Art war es wirklich
+
+## Was Vogelalbum gesagt hat
+
+<!-- Name und Prozentzahl, beides steht an der Sichtung -->
+
+## Das Bild
+
+<!--
+Wenn möglich das Sichtungsfoto anhängen — ohne Bild lässt sich kaum etwas
+machen. Es liegt unter `media/sightings/`, der Ausschnitt unter `media/crops/`.
+Beide dürfen gern mit.
+-->
+
+## Wie oft
+
+- [ ] einmalig
+- [ ] kommt immer wieder bei dieser Art
+
+## Deine Einstellungen
+
+| | |
+|---|---|
+| `VOGELALBUM_REGION` | Vorgabe ist `de` |
+| `min_bird_score` | Vorgabe ist 0.05 |
+| `detect_threshold` | Vorgabe ist 0.4 |
+
+<!--
+Bekannt und nicht meldenswert: Acht heimische Arten kennt das Modell gar nicht
+und ordnet sie Verwandten zu — Sumpf-, Weiden- und Haubenmeise,
+Gartenbaumläufer, Kleinspecht, Bluthänfling, Kernbeißer, Waldkauz. Siehe
+docs/erkennung.md. Eine Meldung lohnt sich trotzdem, wenn die Verwechslung
+eine andere ist als die dort genannte.
+-->