Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,110 @@
+---
+title: WhoRang
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, artificial-intelligence, home-assistant, doorbell, camera, python]
+confidence: medium
+contested: false
+sources: [https://selfh.st/apps/?search=whorang]
+---
+
+# WhoRang 🔔
+> Sonnette connectée et caméra de porte IA, auto-hébergée, qui reconnaît les visiteurs et notifie via Home Assistant.
+
+| Métadonnée | Valeur |
+| :--- | :--- |
+| **Site web** | https://whorang.io |
+| **GitHub** | https://github.com/whorang/whorang |
+| **License** | MIT |
+| **Langage** | Python |
+| **Étoiles** | 9 |
+| **Dernière MAJ** | 2026-02 |
+| **Catégorie** | [[cat-artificial-intelligence]] |
+
+## Description
+
+WhoRang est une application domotique qui transforme n'importe quelle caméra IP ou un Raspberry Pi + module caméra en sonnette intelligente auto-hébergée. Le logiciel détecte les mouvements près de la porte, identifie les visages (modèle FaceNet local), distingue visiteurs, livreurs, voisins et inconnus, puis envoie des notifications enrichies avec miniature, nom et historique de la personne à Home Assistant, Telegram, Gotify ou ntfy.
+
+L'interface web permet d'armer/désarmer l'alerte, de gérer une base de données de visages connus, de revoir les événements et de configurer des automatisations (déclencher une lumière, ouvrir un portier IP, envoyer un message vocal). L'intégration native avec Home Assistant (via MQTT) permet d'enchaîner des scénarios domotiques plus complexes.
+
+Le projet est jeune, peu étoilé (9 ⭐) et l'écosystème reste limité, mais il s'adresse clairement aux bricoleurs qui refusent les sonnettes cloud (Ring, Nest) pour des raisons de confidentialité. Une caméra USB standard suffit pour démarrer. Note de confiance : `low` car le projet évolue vite, l'API peut casser entre versions mineures, et la documentation est encore fragmentaire.
+
+## Installation
+
+### Docker Compose
+
+```yaml
+services:
+  whorang:
+    image: ghcr.io/whorang/whorang:latest
+    container_name: whorang
+    restart: unless-stopped
+    ports:
+      - "8124:8124"
+    devices:
+      - /dev/video0:/dev/video0  # caméra USB (optionnel)
+    environment:
+      - WHORANG_SECRET_KEY=${WHORANG_SECRET_KEY}
+      - MQTT_HOST=mqtt
+      - MQTT_PORT=1883
+      - MQTT_USER=${MQTT_USER}
+      - MQTT_PASS=${MQTT_PASS}
+      - HA_URL=http://homeassistant:8123
+      - HA_TOKEN=${HA_TOKEN}
+    volumes:
+      - whorang_data:/app/data
+    depends_on:
+      - mqtt
+
+  mqtt:
+    image: eclipse-mosquitto:2
+    restart: unless-stopped
+    ports:
+      - "1883:1883"
+    volumes:
+      - mqtt_data:/mosquitto/data
+      - mqtt_conf:/mosquitto/config
+
+volumes:
+  whorang_data:
+  mqtt_data:
+  mqtt_conf:
+```
+
+### Manuelle (Raspberry Pi)
+
+```bash
+git clone https://github.com/whorang/whorang.git
+cd whorang
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+python -m whorang --camera 0
+```
+
+## Configuration
+
+Premier lancement : créer un compte admin via `http://IP:8124`, ajouter une caméra (URL RTSP ou index `/dev/video0`), entraîner la base de visages en uploadant des photos de référence. Le réseau local doit être stable (faible latence caméra → conteneur). Sur Raspberry Pi, limiter la résolution d'analyse à 640×480 pour rester fluide.
+
+## Alternatives
+
+- **Open source** : [[app-frigate]] (détection + reconnaissance), [[app-motioneye]], [[app-zoneminder]], [[app-agent-dvr]], [[app-home-assistant]] (intégrations)
+- **Propriétaire** : Ring (Amazon), Nest Doorbell (Google), Arlo, Eufy, Reolink (cloud partiel)
+
+## Sécurité
+
+Une caméra de sonnette filme la rue et le visage des passants : il s'agit potentiellement de données biométriques soumises au RGPD. Limiter la rétention (purge auto après 7–30 jours), chiffrer le volume `whorang_data` (LUKS), isoler le conteneur sur un VLAN IoT. Activer HTTPS via reverse-proxy (Caddy/Traefik). Désactiver l'accès WAN sauf via VPN (Tailscale, WireGuard). Surveiller les mises à jour — projet jeune, CVE probables.
+
+## Ressources
+
+- Dépôt GitHub : https://github.com/whorang/whorang
+- Forum communautaire : https://community.home-assistant.io
+- Licence : MIT
+- Statut : beta, API instable
+
+## Pages Liées
+
+- [[cat-artificial-intelligence]]
+- [[recettes-docker-compose]]
+- [[app-frigate]]
+- [[app-home-assistant]]