Effi/docs/guide-ace-step.md

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é :

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

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

2.2 : Télécharger le modèle

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

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

---

ÉTAPE 3 : Redémarrer ComfyUI

docker restart comfyui

Attendre 30 secondes, puis vérifier :

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

# 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

# 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