---
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]]