7.1 KiB
title: Civitai Data Manager created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, backups, stable-diffusion, civitai, python, mit, niche] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Backups, https://github.com/jmsltnv/civitai-data-manager]
💾 Civitai Data Manager
Le conservateur de votre bibliothèque Civitai : sauvegardez et organisez les métadonnées (prompts, samplers, hashes, tags) de vos modèles Stable Diffusion, hors-ligne et versionnées.
📋 Informations Générales
| Champ | Valeur |
|---|---|
| Site web | (GitHub) |
| GitHub | jmsltnv/civitai-data-manager |
| License | MIT |
| Langage | Python |
| Étoiles GitHub | 59 ⭐ |
| Dernière MAJ | 2026-06-07 |
| Catégorie | [[cat-backups |
📝 Description
⚠️ App ultra-niche : ciblant uniquement les utilisateurs de Stable Diffusion (Automatic1111, ComfyUI, Forge, SD.Next…) qui téléchargent des modèles et ressources sur Civitai.com.
Civitai Data Manager ne sauvegarde pas les modèles eux-mêmes (un checkpoint LoRA fait couramment 2 à 7 Go, et certains packs pèsent des dizaines de Go). Il se concentre sur ce qui est petit mais critique : les métadonnées Civitai associées à chaque modèle, que vous perdez si Civitai modifie ou supprime une fiche :
- ✅ Snapshot des métadonnées Civitai : titre, description, tags, type (checkpoint / LoRA / VAE / embedding), version, base model
- ✅ Liste des images d'exemple associées à chaque modèle
- ✅ Prompts et paramètres des images d'exemple (sampler, steps, CFG, seed, etc.)
- ✅ Liens de téléchargement des versions archivés (au cas où le modèle n'est plus listé)
- ✅ Hash SHA256 de chaque version (utile pour identifier un modèle sans Civitai)
- ✅ Base SQLite locale interrogeable
- ✅ Export JSON / CSV pour archivage ou migration
- ✅ API Civitai utilisée (pas de scraping)
- ✅ Programmable : CLI + cron pour sauvegarder régulièrement l'ensemble de votre bibliothèque
- ✅ Recherche locale : trouvez un modèle par tag ou par base model même hors-ligne
Public cible : power users Stable Diffusion qui ont accumulé des centaines de modèles / LoRA / embeddings sur Civitai et qui veulent garder une trace de ce qu'ils ont, avec quelle version, et pourquoi. Hors de cette niche, l'app n'a aucun intérêt — voir strategie-backup-321 pour le backup « classique ».
🚀 Installation
Docker Compose
# docker-compose.yml
version: '3.8'
services:
civitai-data-manager:
image: ghcr.io/jmsltnv/civitai-data-manager:latest
container_name: civitai-data-manager
restart: unless-stopped
ports:
- "8125:8000" # UI web (optionnel, pour recherche locale)
volumes:
- cdm-data:/data
- cdm-config:/config
environment:
- TZ=Europe/Paris
- CIVITAI_API_KEY=*** labels:
- "traefik.enable=true"
- "traefik.http.routers.cdm.rule=Host(`cdm.example.com`)"
- "traefik.http.routers.cdm.entrypoints=websecure"
- "traefik.http.routers.cdm.tls.certresolver=letsencrypt"
volumes:
cdm-data:
cdm-config:
ℹ️ Si vous ne voulez que la sauvegarde automatique, vous pouvez ignorer l'UI web et laisser le cron interne faire son travail (exporter en JSON vers un share).
⚙️ Configuration Initiale
- Obtenir une clé API Civitai : compte Civitai > Account Settings > API Key.
- Définir le scope : vous pointez Civitai Data Manager vers un dossier où se trouvent vos modèles (ex.
/mnt/user/models/stable-diffusion/). Le script lit les fichiers, extrait le hash SHA256, et requête Civitai pour trouver la fiche correspondante. - Lancer un premier scan :
docker exec -it civitai-data-manager python -m cdm scan --path /data/models. - Vérifier l'UI :
https://cdm.example.comdoit lister tous vos modèles connus avec leurs métadonnées. - Programmer un scan quotidien :
0 2 * * *dans le conteneur, pour capturer les nouveaux téléchargements. - Exporter régulièrement un JSON/CSV vers un share sauvegardé par app-restic (pour appliquer la règle 3-2-1).
🔄 Alternatives
Open Source
- Civitai Archive (script) — projets ad-hoc de la communauté, moins maintenus.
- SD WebUI Model Manager — extension A1111, pas un backup à proprement parler.
- TagStudio (gestion de bibliothèque de fichiers) — pas spécifique Civitai.
- Hugging Face Hub mirroring — pour les modèles sur HF, complémentaire.
- app-restic — pour backuper les modèles eux-mêmes (les gros fichiers), complémentaire.
Comparaison Civitai Data Manager vs autres
| Critère | Civitai Data Manager | A1111 Model Manager | TagStudio | HF Hub mirror |
|---|---|---|---|---|
| Métadonnées Civitai | ✅ | ❌ | ❌ | ❌ |
| Fichiers modèles | ❌ | Gestion locale | Tags fichiers | ✅ (HF) |
| Multi-SD-UI | ✅ | ❌ (A1111) | ✅ | N/A |
| Hors-ligne | ✅ | ✅ | ✅ | ❌ |
| Prompts d'exemple | ✅ | ❌ | ❌ | ❌ |
| Base de données | SQLite | A1111 native | Fichiers | Git LFS |
| UI web | ✅ | Dans A1111 | ✅ | HF web |
Verdict : uniquement si vous êtes dans la niche (utilisateur Civitai / Stable Diffusion). Pour tous les autres, partez sur app-restic / app-borg / app-kopia pour un backup traditionnel. Voir strategie-backup-321.
Propriétaires
- Civitai Pro / Membership — paye pour la plateforme, pas un backup.
- PixAI / SeaArt — autres plateformes IA, services propriétaires sans backup.
- RunDiffusion / ThinkDiffusion — services cloud d'exécution SD, hors scope.
🔐 Sécurité
- Règle 3-2-1 : la base SQLite Civitai Data Manager est locale au conteneur — exportez-la régulièrement (cron +
cpousqlite3 .backup) vers un share sauvegardé par app-restic ou app-borg pour avoir une 2e et 3e copie (cf. strategie-backup-321). - Chiffrement : les métadonnées Civitai ne sont pas sensibles (noms de modèles, prompts, tags), mais si vous avez stocké votre clé API Civitai dans le conteneur, chiffrez le volume
cdm-configau niveau OS. Voir securisation-home-lab. - Clé API : passez la clé Civitai via variable d'environnement, jamais dans le
docker-compose.ymlversionné sur Git. Révoquez et regénérez si elle fuit. - Test de restauration : ce n'est pas un backup critique, mais exportez un JSON tous les mois et vérifiez qu'il s'ouvre correctement (par ex.
jq . fichier.json | head).
📚 Ressources
Pages Liées
- cat-backups — Catégorie Backups
- strategie-backup-321 — Règle 3-2-1
- app-restic — Pour backuper les modèles eux-mêmes
- app-borg — Alternative à Restic
- app-kopia — Backup avec UI
- app-portainer — Gestion conteneurs
- securisation-home-lab — Bonnes pratiques