Civitai Data Manager

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 suppr

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

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).