CAIRN est une application web (Gradio) de détection et de comptage automatique de la fréquentation sur les sites naturels de montagne — lacs d'altitude, zones de bivouac — développée dans le cadre des projets PLOUF et BiodivTourAlps (Parc national des Écrins / LECA).

Elle permet d'analyser des séries d'images (issues de caméras timelapse) pour détecter et compter automatiquement les baigneurs, les tentes ou autre classes relatives à la fréquentation, à l'aide de modèles de vision par ordinateur (YOLO, SAM3).

L'interface permet de :

• 📥 Importer un lot d'images à analyser
• 🤖 Choisir un modèle de détection (YOLO ou SAM3)
• ✅ Sélectionner les classes à détecter (tente ou baigneur pour YOLO, prompt libre pour SAM3)
• ⚙️ Ajuster les paramètres du modèle (seuil de confiance et tiling optionnel)
• ▶️ Lancer l'analyse et consulter les résultats dans un tableau détaillé par image
• 👁️ Visualiser les détections (bounding boxes) directement sur les images
• 📤 Exporter l'ensemble des résultats au format CSV

➡️ Documentation utilisateur complète : voir docs/guide_utilisateur.md.

• Python ≥ 3.10
• Git LFS (images d'exemple et poids du modèle YOLO entraîné)
• GPU CUDA recommandé pour SAM3

git lfs install
git clone https://github.com/PnEcrins/CAIRN.git
cd CAIRN
git lfs pull

cp config.yaml.sample config.yaml

Plus d'informations sur la configuration : docs/guide_admin.md.

python -m venv .venv
source .venv/bin/activate   # Windows : .venv\Scripts\activate

pip install .
# ou uv sync

python app.py

L'application est servie en local par défaut sur http://127.0.0.1:7860

docker-compose up -d

ou via l'image Docker officielle (GitHub Container Registry) :

docker run -d -p 80:7860 -v ./config.yaml:/app/config.yaml --name cairn ghcr.io/pnecrins/cairn:latest

➡️ Guide pas-à-pas de l'interface : docs/guide_utilisateur.md.

➡️ Détails (classes, mapping, tiling, licences) : docs/modeles.md.

SAM3 est un modèle propriétaire (licence non commerciale) et n'est pas inclus dans le dépôt. Pour l'utiliser, il faut :

1. Créer un compte sur Hugging Face.
2. Accepter les conditions d'utilisation du modèle SAM3 (licence non commerciale).
3. Télécharger le fichier sam3.pt depuis la page facebook/sam3.
4. Placer le fichier sam3.pt dans le dossier CAIRN/model_weights/.

docker run -d -p 80:7860 -v ./config.yaml:/app/config.yaml -v ./model_weights/sam3.pt:/app/model_weights/sam3.pt --name cairn ghcr.io/pnecrins/cairn:latest

L'apparence de l'application (logos, couleurs, thème, seuils par défaut) est centralisée en tête de CAIRN/app.py.

Performances indicatives (validation interne, jeu de données aérien/drone des lacs de montagne — Anterne, Lauvitel, Muzelle, Pormenaz, Lauzon, Brevent, Cornu, Jovet) :

Ces chiffres sont indicatifs et dépendent fortement du jeu de données d'évaluation, des conditions de prise de vue (altitude, luminosité, résolution) et de l'activation ou non du tiling.

• Parc national des Écrins — pilotage du projet, terrain, charte graphique.
• LECA (Laboratoire d'Écologie Alpine) — appui scientifique (Vincent Miele).
• Projets PLOUF & BiodivTourAlps — financement et cadre des travaux de suivi de la fréquentation.

Ce projet est distribué sous licence AGPL-3.0 — voir LICENSE.

Toute la documentation utilisateur est disponible dans le dossier docs/ :

• Guide utilisateur
• Guide administrateur