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

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

---

## Prérequis

- ✅ ComfyUI installé sur Folzo Corp (192.168.1.11:8188)
- ✅ Custom node ACE-Step installé
- ✅ RX 7800 XT 16GB VRAM
- ✅ ~5GB d'espace libre

---

## ÉTAPE 1 : Vérifier le custom node ACE-Step

Sur **Folzo Corp**, vérifier que le custom node ACE-Step est installé :

```bash
ls -la ~/Documents/OpenCode/Projets/Effi/comfyui/custom_nodes/
```

Tu dois voir un dossier type `ComfyUI-ACE-Step-Audio` ou similaire.

---

## ÉTAPE 2 : Télécharger le modèle ACE-Step 1.5

### 2.1 : Créer le dossier

```bash
mkdir -p ~/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step
```

### 2.2 : Télécharger le modèle

```bash
cd ~/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step

wget "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/acestep-v15-turbo/model.safetensors" \
  -O acestep-v15-turbo.safetensors
```

Le fichier fait environ **3-4GB**, ça peut prendre du temps.

### 2.3 : Vérifier le téléchargement

```bash
ls -lh ~/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step/
```

---

## ÉTAPE 3 : Redémarrer ComfyUI

```bash
docker restart comfyui
```

Attendre 30 secondes, puis vérifier :

```bash
curl http://localhost:8188/system_stats
```

---

## ÉTAPE 4 : Configurer le Tool dans OpenWebUI

### 4.1 : Ouvrir OpenWebUI

Dans ton navigateur : http://192.168.1.27:3000

### 4.2 : Aller dans Admin Panel

Clique sur ton **profil** (en bas à gauche) → **Admin Panel**

### 4.3 : Aller dans Tools

Clique sur **Tools** dans le menu latéral

### 4.4 : Configurer Generate Song

1. Trouve le tool **"Generate Song"** que tu as installé
2. Clique sur l'icône **Valves** (roue dentée)
3. Configure ces paramètres :

| Paramètre | Valeur |
|-----------|--------|
| `comfyui_api_url` | `http://192.168.1.11:8188` |
| `model_name` | `acestep-v15-turbo.safetensors` |
| `max_duration` | `180` |
| `max_wait_time` | `600` |

4. Clique **Save**

---

## ÉTAPE 5 : Tester la génération

### 5.1 : Test via OpenWebUI

1. Ouvre une conversation avec Effi
2. Active le tool **Generate Song**
3. Tape un prompt comme :

```
Génère une chanson "electro, synthwave" sur le thème "voyage dans l'espace", durée 60 secondes
```

### 5.2 : Test via ComfyUI directement

1. Ouvre http://192.168.1.11:8188
2. Charge le workflow ACE-Step
3. Clique **Queue Prompt**

---

## 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
```

---

## Dépannage

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

```bash
# Vérifier que le fichier existe
ls -lh ~/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step/

# Redémarrer ComfyUI
docker restart comfyui
```

### Erreur de VRAM

ACE-Step 1.5 nécessite environ **4GB VRAM**. Si tu as d'autres modèles chargés :
- Fermer les autres sessions ComfyUI
- Attendre que la VRAM se libère

### Le tool ne fonctionne pas dans OpenWebUI

Vérifier que `comfyui_api_url` pointe vers `http://192.168.1.11:8188` (l'adresse de Folzo Corp, pas effi-server)

---

## Exemples de Prompts

```
# Electro synthwave
"Generate an 80s synthwave song about neon cities"

# Rock metal
"Generate a heavy metal song about dragons and fantasy"

# French song
"Génère une chanson française, style chanson réaliste, sur l'amour perdu"

# Chill ambient
"Generate a chill ambient track, relaxing, nature sounds"
```

---

## Informations sur le Modèle

| Caractéristique | Valeur |
|-----------------|--------|
| **Nom** | ACE-Step 1.5 Turbo |
| **License** | MIT (commercial OK) |
| **VRAM** | < 4GB |
| **Langues** | 50+ dont Français |
| **Durée max** | 10 minutes |

---

## Pour Aller Plus Loin

### Personnaliser le Workflow

Tu peux modifier le workflow ACE-Step dans ComfyUI pour :
- Changer le BPM
- Changer la clé musicale
- Ajouter des instruments
- Générer des paroles

### Batch Generation

Configure `batch_size` dans les valves pour générer plusieurs versions à la fois.

---

*Document créé: Avril 2026*