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.com doit 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 + cp ou sqlite3 .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-config au niveau OS. Voir securisation-home-lab.
Clé API : passez la clé Civitai via variable d'environnement, jamais dans le docker-compose.yml versionné 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

7.1 KiB Raw Permalink Blame History Unescape Escape