Files
wiki/Catalogue-Self-Hosted/apps/app-damselfly.md
T
2026-06-09 18:40:21 +02:00

106 lines
4.1 KiB
Markdown

---
title: Damselfly
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, photos, ai, tagging, recognition, dotnet, self-hosted]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Photos, https://github.com/Webreaper/Damselfly]
---
# 📸 Damselfly
> **Gestionnaire de photos avec tagging IA local** : reconnaissance d'objets, de visages et de scènes, le tout sur votre propre machine sans envoyer vos photos dans le cloud.
## 📋 Informations Générales
| Attribut | Valeur |
|----------|--------|
| **Nom** | Damselfly |
| **Slug** | app-damselfly |
| **Description** | Gestionnaire de photos avec IA de tagging locale |
| **Site officiel** | [damselfly.info](https://damselfly.info) |
| **Repository** | [Webreaper/Damselfly](https://github.com/Webreaper/Damselfly) |
| **Stars** | 1 769 ⭐ |
| **Licence** | GPL-3.0 |
| **Langage principal** | C#, .NET, Blazor |
| **Catégorie** | Photos |
| **Tags** | [catalogue, photos, ai, tagging, recognition, dotnet, self-hosted] |
## 📝 Description
**Damselfly** est un gestionnaire de photos complet écrit en **.NET/Blazor** qui mise sur l'**intelligence artificielle locale** pour tagger automatiquement vos photos. Concrètement, le projet embarque plusieurs modèles ML (YOLO pour la détection d'objets, modèles faciaux) et les exécute sur votre serveur — aucune photo ne quitte votre réseau.
Fonctionnalités : **reconnaissance d'objets** (chat, chien, voiture, arbre… 80+ catégories COCO), **détection et regroupement de visages** (clustering), **recherche textuelle** sur les tags générés, **carte géographique** depuis EXIF GPS, **timeline chronologique**, **gestion des dossiers** (folder-based), **indexation en tâche de fond** (file d'attente), **support RAW** étendu, **intégration avec Immich/PhotoPrism** pour la coexistence.
L'**UI Blazor** est moderne et rapide. L'**avantage clé** par rapport à Immich/PhotoPrism : Damselfly peut fonctionner en mode **autonome** (juste indexer et tagger) ou en **compagnon** d'un autre serveur, doublant les capacités IA.
⚠️ **Hardware** : la reconnaissance d'objets est consommatrice. Un GPU est fortement recommandé pour des performances acceptables, mais le CPU-only fonctionne (lentement).
## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
damselfly:
image: webreaper/damselfly:latest
container_name: damselfly
restart: unless-stopped
volumes:
- /mnt/photos:/photos:ro
- damselfly-data:/data
- damselfly-config:/config
ports:
- 8082:8080
# Activer GPU NVIDIA si dispo
# deploy:
# resources:
# reservations:
# devices:
# - driver: nvidia
# count: 1
# capabilities: [gpu]
```
### Installation manuelle
Application .NET — publier via `dotnet publish` puis exécuter en service Windows/Linux.
## ⚙️ Configuration
- **Dossier source** : montage du dossier photos, idéalement en `:ro`.
- **Modèles IA** : téléchargés automatiquement au premier lancement (plusieurs Go).
- **GPU** : activer CUDA ou ROCm pour 10x à 50x d'accélération.
- **Intégrations** : optionnel, lien vers Immich/PhotoPrism via API.
- **Reverse proxy** : trivial (app web .NET).
## 🔗 Alternatives
- **[[app-immich]]** — Plus simple à déployer, IA aussi intégrée
- **[[app-photoprism]]** — Très mature, IA également locale
- **[[app-immich-power-tools]]** — Outil complémentaire à Immich
## 🔒 Sécurité
- **Lecture seule des photos** : montage `:ro` impératif.
- **Pas d'auth utilisateur par défaut** : activer via reverse proxy (BasicAuth) ou intégration.
- **Surface .NET** : garder l'image à jour pour les CVE.
- **Stockage des tags** : base SQLite locale, à sauvegarder.
## 📚 Ressources
- [Site officiel](https://damselfly.info)
- [Repository GitHub](https://github.com/Webreaper/Damselfly)
- [Wiki Damselfly](https://github.com/Webreaper/Damselfly/wiki)
## 🔗 Pages Liées
- [[cat-photos]]
- [[app-immich]]
- [[app-photoprism]]
- [[app-traefik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]