# Halloween: interaktives atmendes Grab

Raspberry-Pi-Projekt für eine Halloween-Grabattrappe mit Kamera,
Weboberfläche und geplantem Effektablauf.

Die erste Softwareversion bietet ein Picamera2-Livebild, einen Demo-Feed,
gespeicherte Moduswahl, einen simulierten Effektablauf sowie eine lokale
SQLite-Datenbank für Testereignisse und manuell zugeordnete Profile.
GPIO-Steuerung, automatische Personenerkennung und Aufnahme von Clips
sind noch nicht umgesetzt. Die echte Kamera und die Aktoren sind noch
nicht praktisch geprüft.

## Lokal ohne Hardware starten

```bash
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python run.py --demo
```

Danach `http://127.0.0.1:8000` öffnen. Das Bild ist synthetisch und als
Demo gekennzeichnet. `run.py` bindet ausschließlich an `127.0.0.1`.
Für den Zugriff auf einen Pi ist ein SSH-Tunnel vorgesehen; der alternative
manuelle Start für direkten Heimnetzzugriff steht in [SOFTWARE.md](SOFTWARE.md).

## Dokumentation

- [Software, Pi-Einrichtung und lokale Prüfungen](SOFTWARE.md)
- [Projektdateien auf den Pi übertragen](UPLOAD.md)
- [Arbeitsplan, Hardwarestand und offene Entscheidungen](PLAN.md)
- [Blender-Konzeptvorschau](preview/README.md)
- [Projektregeln](AGENTS.md)

Code, Planung und bearbeitbare Blender-Szenen werden versioniert.
Laufzeitdaten unter `data/`, `.venv`, Referenzclips und gerenderte
Bilder/Videos bleiben lokal. Die Blender-Vorschau ist eine Simulation;
einige Schnittprojekte benötigen zusätzlich die lokal erzeugten Bildsequenzen.