# Guide Installation ACE-Step 1.5 - Génération de Musique

Ce guide explique comment installer et utiliser ACE-Step 1.5 pour générer de la musique avec ComfyUI et OpenWebUI.

---

## 📋 Résumé

ACE-Step 1.5 est un modèle de génération musicale open-source :
- **License**: MIT (commercial OK)
- **VRAM**: < 4GB (fonctionne sur RX 7800 XT 16GB)
- **Langues**: 50+ dont Français
- **Durée**: Jusqu'à 10 minutes par chanson
- **Temps de génération**: ~10 secondes sur GPU

---

## MODÈLES REQUIS

### Fichiers à télécharger

| Modèle | Taille | Emplacement |
|--------|--------|-------------|
| `ace_step_1.5_turbo_aio.safetensors` | ~9.4GB | `models/checkpoints/` |
| `qwen_0.6b_ace15.safetensors` | ~1.2GB | `models/checkpoints/` |
| `qwen_1.7b_ace15.safetensors` | ~3.5GB | `models/checkpoints/` |
| `ace_1.5_vae.safetensors` | ~322MB | `models/vae/` |

---

## ÉTAPE 1 : Télécharger les modèles

### Option A : Via ComfyUI Manager (recommandé)

1. Ouvrir http://192.168.1.11:8188
2. Cliquer sur **Manager**
3. Cliquer **Download Models**
4. Chercher et télécharger :
   - `ace_step_1.5_turbo_aio`
   - `qwen_0.6b_ace15`
   - `qwen_1.7b_ace15`

### Option B : Via terminal

```bash
# Sur Folzo Corp
mkdir -p ~/ace-models
cd ~/ace-models

# Télécharger le modèle principal AIO (~9.4GB)
curl -L "https://huggingface.co/Comfy-Org/ace_step_1.5_ComfyUI_files/resolve/main/checkpoints/ace_step_1.5_turbo_aio.safetensors" \
  -o ace_step_1.5_turbo_aio.safetensors

# Télécharger les text encoders
curl -L "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/Qwen3-Embedding-0.6B/model.safetensors" \
  -o qwen_0.6b_ace15.safetensors

curl -L "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/acestep-5Hz-lm-1.7B/model.safetensors" \
  -o qwen_1.7b_ace15.safetensors

# Copier vers ComfyUI (besoin sudo)
sudo cp *.safetensors /home/folzo/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/
```

---

## ÉTAPE 2 : Redémarrer ComfyUI

```bash
docker restart comfyui
```

Attendre ~30 secondes puis vérifier :
```bash
curl http://localhost:8188/system_stats
```

---

## ÉTAPE 3 : Charger le workflow ACE-Step

1. Ouvrir http://192.168.1.11:8188
2. Dans la liste des templates, chercher **"ACE-Step 1.5 Génération de Musique AIO"**
3. Cliquer pour charger le workflow

### Si des modèles sont manquants (surlignés en rouge) :

1. Cliquer sur le nœud **DualCLIPLoader**
2. Sélectionner :
   - `clip_name1` : `qwen_0.6b_ace15.safetensors`
   - `clip_name2` : `qwen_1.7b_ace15.safetensors`

3. Cliquer sur **Queue Prompt**

---

## ÉTAPE 4 : Configurer le Tool OpenWebUI

### 4.1 : Vérifier le custom node JK-AceStep

Le tool "Generate Song" d'OpenWebUI nécessite le custom node **JK-AceStep-Nodes**.

Dans ComfyUI :
1. **Manager** → **Install Custom Nodes**
2. Chercher **"JK-AceStep-Nodes"**
3. Installer et redémarrer

### 4.2 : Configurer le tool

1. Ouvrir http://192.168.1.27:3000
2. **Admin Panel** → **Tools**
3. Cliquer sur **Generate Song** → **Valves**
4. Configurer :
   - `comfyui_api_url` : `http://192.168.1.11:8188`
   - `model_name` : `ace_step_1.5_turbo_aio.safetensors`

---

## ÉTAPE 5 : Tester

### Test dans ComfyUI

1. Charger le workflow "ACE-Step 1.5 Génération de Musique AIO"
2. Modifier le prompt (tags de style)
3. Cliquer **Queue Prompt**

### Test dans OpenWebUI

1. Activer le tool **Generate Song**
2. Taper :
```
Génère une chanson rock мощный, 60 secondes
```

---

## COMMANDES UTILES

```bash
# Voir les logs ComfyUI
docker logs -f comfyui

# Redémarrer ComfyUI
docker restart comfyui

# Vérifier VRAM utilisée
rocm-smi

# Espace disque
df -h
```

---

## EXEMPLES DE PROMPTS

```
# Rock energique
"pop, actuel, amour, sentimental, rythmé"

# Electro synthwave
"electro, synthwave, 80s, neon"

# Metal
"heavy metal, dragons, fantasy, powerful"

# Française
"chanson française, réaliste, amour perdu, emotif"
```

---

## DÉPANNAGE

### "No audio files generated"

- Vérifier que le custom node JK-AceStep est installé
- Vérifier que tous les modèles sont dans ComfyUI
- Redémarrer ComfyUI

### "VAE is invalid"

- ACE-Step 1.5 Turbo AIO n'utilise pas de VAE externe
- Charger le modèle depuis le bon dossier

### Modèles non visibles

- Redémarrer ComfyUI après ajout des modèles
- Vérifier les permissions des fichiers

---

## LIENS UTILES

- [ACE-Step Official](https://ace-step.github.io/)
- [ComfyUI ACE Workflows](https://comfyanonymous.github.io/ComfyUI_examples/)
- [JK-AceStep-Nodes](https://github.com/jeankassio/JK-AceStep-Nodes)

---

*Document créé: Avril 2026*