Effi/comfyui/docs/MODELS.md

# 🎨 Catalogue des Modèles SDXL pour ComfyUI

Guide complet des modèles disponibles avec réglages optimaux et cas d'usage.

---

## 📋 Table des matières

- [Installation des modèles](#installation-des-modèles)
- [Modèles Photoréalistes](#-modèles-photoréalistes)
- [Modèles Art/Stylisés](#-modèles-artstylisés)
- [Modèles Rapides](#-modèles-rapides)
- [Configuration OpenWebUI](#configuration-openwebui)
- [Conseils de prompts](#conseils-de-prompts)

---

## Installation des modèles

### Téléchargement rapide

```bash
# Lancer le script interactif
cd ~/Documents/OpenCode/Projets/Effi/comfyui
./download-more-models.sh

# Ou télécharger manuellement avec wget
wget -O models/checkpoints/NOM_DU_MODELE.safetensors \
  "URL_DU_MODELE"
```

### Espace disque nécessaire

| Configuration | Taille | Usage VRAM |
|--------------|--------|-----------|
| 1 modèle | ~7 GB | 8-10 GB |
| 3 modèles | ~21 GB | 8-10 GB (1 à la fois) |
| Tous les modèles | ~35 GB | 8-10 GB (1 à la fois) |

**Note** : La VRAM utilisée reste la même quel que soit le nombre de modèles installés (on ne charge qu'un modèle à la fois).

---

## 📸 Modèles Photoréalistes

### 1. RealVisXL V4.0 ⭐ (Recommandé portraits)

**Fichier** : `RealVisXL_V4.0.safetensors`

**Description** : Le meilleur pour les portraits ultra-réalistes. Excellent rendu de la peau, des yeux et des détails faciaux.

**Cas d'usage** :
- Portraits professionnels
- Photos de personnes
- Headshots LinkedIn
- Retouches réalistes

**Réglages optimaux** :
```yaml
Étapes: 40-50
Guidance Scale (CFG): 7-8
Sampler: dpmpp_2m_sde
Résolution: 1024x1024 (portrait) ou 896x1152
```

**Prompts conseillés** :
```
# Portrait professionnel
professional photo of a person, 8k uhd, dslr, soft lighting, high quality, film grain, Fujifilm XT3

# Portrait détaillé
raw photo, detailed skin texture, professional lighting, sharp focus, 8k uhd, dslr
```

**Prompts négatifs** :
```
(worst quality, low quality, normal quality:2), blurry, (text, watermark, signature:1.5), deformed, mutated, disfigured
```

---

### 2. Juggernaut XL v9 ⭐ (Recommandé polyvalent)

**Fichier** : `Juggernaut-XL-v9.safetensors`

**Description** : Très polyvalent, excellent compromis entre qualité et vitesse. Fonctionne bien pour tous les types d'images.

**Cas d'usage** :
- Usage général
- Paysages
- Objets produits
- Concepts variés

**Réglages optimaux** :
```yaml
Étapes: 30-40
Guidance Scale (CFG): 7-8
Sampler: dpmpp_2m
Résolution: 1024x1024
```

**Prompts conseillés** :
```
# Paysage
beautiful landscape, mountains at sunset, dramatic clouds, cinematic lighting, 8k, highly detailed

# Produit
product photography, sleek modern laptop on wooden desk, professional lighting, commercial style
```

---

### 3. Proteus V0.4

**Fichier** : `ProteusV0.4.safetensors`

**Description** : Alternative à RealVisXL avec un excellent photoréalisme. Très bon pour la texture de la peau.

**Cas d'usage** :
- Portraits
- Mode/Fashion
- Architecture intérieure

**Réglages optimaux** :
```yaml
Étapes: 30-40
Guidance Scale (CFG): 6-7
Sampler: dpmpp_2m
Résolution: 1024x1024
```

**Prompts conseillés** :
```
raw photo, realistic, detailed skin texture, professional lighting, sharp focus, fashion photography
```

---

## 🎨 Modèles Art/Stylisés

### 4. DreamShaper XL 1.0 ⭐ (Recommandé art/fantasy)

**Fichier** : `DreamShaperXL1.0.safetensors`

**Description** : Excellent pour l'art numérique, les illustrations et la fantasy. Style artistique très marqué.

**Cas d'usage** :
- Art conceptuel
- Fantasy
- Illustrations
- Book covers
- Jeux vidéo assets

**Réglages optimaux** :
```yaml
Étapes: 30-40
Guidance Scale (CFG): 7-8
Sampler: dpmpp_2m
Résolution: 1024x1024 ou 1216x832 (paysage)
```

**Prompts conseillés** :
```
# Fantasy épique
epic fantasy scene, dragon flying over castle, dramatic lighting, highly detailed, digital art, artstation

# Art style
oil painting style, portrait of a wizard, mystical atmosphere, rich colors, masterpiece, 8k

# Illustration
children book illustration, cute forest animals, watercolor style, soft colors, whimsical
```

**Prompts négatifs** :
```
photograph, realistic, 3d render, photography, (text, signature, watermark:1.5), bad anatomy, bad proportions
```

---

### 5. SDXL Base 1.0 (Modèle de base)

**Fichier** : `sd_xl_base_1.0.safetensors`

**Description** : Le modèle officiel Stability AI. Très stable et prévisible. Bon point de départ.

**Cas d'usage** :
- Tests
- Benchmarks
- Usage général

**Réglages optimaux** :
```yaml
Étapes: 30-40
Guidance Scale (CFG): 7-8
Sampler: euler
Résolution: 1024x1024
```

---

## ⚡ Modèles Rapides

### 6. SDXL Lightning 8-step

**Fichier** : `sdxl_lightning_8step.safetensors`

**Description** : Génération ultra-rapide en seulement 8 étapes ! Qualité légèrement inférieure mais 4x plus rapide.

**Cas d'usage** :
- Tests rapides
- Prototypage
- Génération en masse
- Quand la vitesse est prioritaire

**⚠️ Réglages SPÉCIAUX obligatoires** :
```yaml
Étapes: 8 (OBLIGATOIRE - pas plus, pas moins)
Guidance Scale (CFG): 1.0-2.0 (IMPORTANT : garder bas)
Sampler: euler
Résolution: 1024x1024
```

**Prompts conseillés** :
```
# Fonctionne avec tous les styles
a beautiful landscape, mountains, sunset
a cute cat, sitting on a table
professional portrait of a person
```

**Note** : N'utilisez PAS de CFG élevé (7-8) avec ce modèle, ça détruit la qualité.

---

## 🔧 Configuration OpenWebUI

### Changement de modèle

1. **Admin Panel** → **Settings** → **Images**
2. Modifie le champ **"Modèle"** avec le nom exact du fichier :
   - `RealVisXL_V4.0.safetensors`
   - `Juggernaut-XL-v9.safetensors`
   - `DreamShaperXL1.0.safetensors`
   - `sdxl_lightning_8step.safetensors`
3. Sauvegarde

### Paramètres selon le modèle

| Modèle | Étapes | CFG | Usage |
|--------|--------|-----|-------|
| RealVisXL | 40-50 | 7-8 | Portraits |
| Juggernaut | 30-40 | 7-8 | Polyvalent |
| DreamShaper | 30-40 | 7-8 | Art/Fantasy |
| Lightning | 8 | 1-2 | Rapide |

---

## 💡 Conseils de Prompts

### Traduction automatique

**Important** : SDXL est entraîné principalement en **anglais**. Les prompts en français donnent des résultats imprévisibles.

**Solution** : Ajoutez dans le prompt système d'Effi :
```
# Génération d'images
- Traduire TOUJOURS les demandes d'image en anglais
- Exemple : "chat astronaute" → "cute cat astronaut in space suit"
- Ajouter des détails : style, éclairage, qualité
```

### Structure d'un bon prompt

```
[Sujet principal], [détails], [style], [éclairage], [qualité]

Exemple :
a cute orange cat wearing astronaut suit, fluffy fur, sitting on moon surface, earth in background, Pixar 3D style, soft cinematic lighting, highly detailed, 8k, masterpiece
```

### Prompts négatifs efficaces

**Générique (fonctionne pour tout)** :
```
(worst quality, low quality, normal quality:2), blurry, (text, watermark, signature:1.5), deformed, mutated, disfigured, bad anatomy, bad proportions
```

**Pour photoréalisme** :
```
painting, drawing, illustration, cartoon, anime, 3d render, cg, sketch, (text, signature, watermark:1.5)
```

**Pour art stylisé** :
```
photograph, realistic, 3d render, photography, (text, signature, watermark:1.5), bad anatomy
```

### Renforcer des mots-clés

Utilisez des parenthèses pour donner plus de poids :
- `((chat))` → poids x1.21
- `(((chat)))` → poids x1.33
- `(chat:1.5)` → poids x1.5

Exemple :
```
((cute cat)) astronaut, ((fluffy fur)), space suit, moon background
```

---

## 🖼️ Résolutions recommandées

| Format | Dimensions | Usage |
|--------|-----------|-------|
| Carré | 1024x1024 | Standard, polyvalent |
| Portrait | 832x1216 ou 896x1152 | Personnes, portraits |
| Paysage | 1216x832 ou 1152x896 | Paysages, scènes larges |
| Panoramique | 1344x768 | Paysages très larges |

**Note** : SDXL fonctionne mieux avec des multiples de 64.

---

## 🚀 Workflows avancés

### Img2img (Modification d'image)

Pour modifier une image existante, utilisez **l'interface ComfyUI directement** (pas OpenWebUI) :

1. Chargez une image avec le node **"Load Image"**
2. Connectez-la à un workflow img2img
3. Réglez le **denoise** :
   - `0.3-0.4` : Légères modifications (style, couleurs)
   - `0.5-0.6` : Modifications modérées
   - `0.7-1.0` : Transformations majeures

### Utiliser le VAE séparé

Pour de meilleures couleurs avec tous les modèles :
1. Téléchargez le VAE : `./download-more-models.sh` → option 7
2. Dans le workflow ComfyUI, utilisez le node **"Load VAE"**
3. Connectez-le au node **"VAEDecode"**

---

## 📊 Comparaison rapide

| Besoin | Modèle recommandé | Pourquoi |
|--------|------------------|----------|
| Portrait photo réaliste | **RealVisXL** | Meilleur rendu peau |
| Usage quotidien | **Juggernaut XL** | Polyvalent, stable |
| Art/Fantasy | **DreamShaper** | Style artistique |
| Tests rapides | **Lightning** | 4x plus rapide |
| Premier essai | **SDXL Base** | Stable, prévisible |

---

## 🆘 Dépannage

### Le modèle n'apparaît pas dans OpenWebUI

1. Vérifier le nom exact du fichier (sensible à la casse)
2. Redémarrer ComfyUI : `sudo docker restart comfyui`
3. Vérifier que le fichier est bien dans `models/checkpoints/`

### Images déformées/moches

- Augmenter les étapes (30 → 40)
- Vérifier le CFG (pas trop élevé avec Lightning)
- Améliorer le prompt avec plus de détails
- Utiliser des prompts négatifs

### Pas assez de VRAM

- Réduire la résolution (1024→896)
- Fermer Ollama temporairement : `docker stop ollama`
- Utiliser Lightning (moins gourmand)

### Images floues

- Augmenter les étapes
- Ajouter "sharp focus, highly detailed" au prompt
- Réduire le denoise en img2img

---

## 🔗 Ressources

- **CivitAI** : https://civitai.com (modèles communautaires)
- **HuggingFace** : https://huggingface.co/models (modèles officiels)
- **ComfyUI Examples** : https://comfyanonymous.github.io/ComfyUI_examples/

---

*Document mis à jour le 6 avril 2026*
*Pour Effi - Configuration RX 7800 XT*