christian
c11fe9ab04
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.
56 lines
2.4 KiB
Markdown
56 lines
2.4 KiB
Markdown
# Mitmachen
|
|
|
|
Fehlerberichte, Verbesserungen und neue Kameraanbindungen sind willkommen.
|
|
Dieses Projekt ist zum Nachbauen gedacht — wer es aufbaut und dabei über eine
|
|
rauhe Kante stolpert, hilft mit einem Hinweis mehr als mit Schweigen.
|
|
|
|
## Fehler melden
|
|
|
|
Am nützlichsten ist ein Bericht, aus dem hervorgeht, **was du erwartet hast und
|
|
was stattdessen passiert ist**. Dazu:
|
|
|
|
- Welche Kamera (Pi Zero, ESP32-S3, etwas anderes) und welche Auflösung
|
|
- Die letzten Zeilen aus dem Protokoll des Detectors
|
|
- Bei Erkennungsfehlern: wenn möglich das Bild, um das es geht
|
|
|
|
⚠️ **Schwärze deine Zugangsdaten**, bevor du ein Protokoll einfügst — Tokens
|
|
stehen dort im Klartext.
|
|
|
|
## Code beisteuern
|
|
|
|
1. Bevor du etwas Größeres baust: ein Issue aufmachen und kurz abstimmen. Das
|
|
erspart dir die Arbeit, die ich vielleicht gerade selbst mache.
|
|
2. Die Tests müssen durchlaufen — **aus dem Ordner `web/` heraus**, sonst
|
|
findet Django keinen einzigen Test und meldet trotzdem Erfolg:
|
|
|
|
```bash
|
|
cd web && ../venv/bin/python manage.py test
|
|
```
|
|
|
|
Es sind derzeit 105.
|
|
3. Kommentare und Oberfläche sind auf Deutsch, der Code folgt dem Stil der
|
|
Umgebung, in der er steht.
|
|
|
|
## Lizenz deines Beitrags
|
|
|
|
Dieses Projekt steht unter der **GNU AGPL-3.0** (siehe [LICENSE](LICENSE)), und
|
|
dein Beitrag wird unter derselben Lizenz veröffentlicht.
|
|
|
|
🔑 **Zusätzlich räumst du mir mit dem Einreichen eines Beitrags das Recht ein,
|
|
ihn auch unter anderen Lizenzbedingungen zu verwenden** — einschließlich einer
|
|
kommerziellen Lizenz. Das Recht ist einfach, zeitlich und räumlich unbeschränkt
|
|
und übertragbar. Die Urheberschaft bleibt bei dir, und dein Beitrag bleibt
|
|
selbstverständlich auch unter der AGPL verfügbar.
|
|
|
|
**Warum das nötig ist, offen gesagt:** Vogelalbum wird zusätzlich kommerziell
|
|
lizenziert — wer es in einem Produkt einsetzen will, ohne seinen eigenen
|
|
Quelltext offenlegen zu müssen, kann eine solche Lizenz erwerben. Doppelt
|
|
lizenzieren darf aber nur, wem alle Rechte am Werk zustehen. Ohne diese
|
|
Einräumung könnte ein einziger fremder Beitrag diesen Weg für das ganze
|
|
Projekt versperren, und das ließe sich später kaum noch reparieren, weil
|
|
dafür jeder Mitwirkende einzeln zustimmen müsste.
|
|
|
|
Wenn du damit nicht einverstanden bist, sag es bitte **vor** dem Einreichen.
|
|
Dann finden wir einen anderen Weg — ein Fehlerbericht mit genauer Beschreibung
|
|
ist oft genauso wertvoll wie fertiger Code, und für ihn gilt das alles nicht.
|