Effi/docs/guide-ace-step.md

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

# 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

docker restart comfyui

Attendre ~30 secondes puis vérifier :

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

# 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
• ComfyUI ACE Workflows
• JK-AceStep-Nodes

---

Document créé: Avril 2026