feat: add ACE-Step 1.5 music generation support

- Add docs/guide-ace-step.md with complete installation guide
- Add comfyui/download-ace-step.sh script for downloading model
- Add ComfyUI-Unload-Model custom node for model memory management

ACE-Step 1.5 Turbo: MIT license, <4GB VRAM, 50+ languages
This commit is contained in:
Folzo
2026-04-08 22:20:54 +02:00
parent 339dac1435
commit 2c46c45a64
3 changed files with 266 additions and 0 deletions
Submodule comfyui/custom_nodes/ComfyUI-Unload-Model added at ac5ffb4ed0
+57
View File
@@ -0,0 +1,57 @@
#!/bin/bash
# Script de téléchargement ACE-Step 1.5 Turbo
# Usage: bash download-ace-step.sh
set -e
MODEL_DIR="/home/folzo/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step"
echo "🎵 ACE-Step 1.5 Turbo - Téléchargement"
echo "================================"
echo ""
# Créer le dossier si nécessaire
mkdir -p "$MODEL_DIR"
# Vérifier si wget est disponible
if ! command -v wget &> /dev/null; then
echo "❌ wget non trouvé. Installation..."
sudo apt update && sudo apt install wget
fi
cd "$MODEL_DIR"
# Vérifier si le modèle existe déjà
if [ -f "acestep-v15-turbo.safetensors" ]; then
echo "✅ Le modèle existe déjà :"
ls -lh acestep-v15-turbo.safetensors
echo ""
echo "Pour re-télécharger, supprimez d'abord le fichier :"
echo "rm $MODEL_DIR/acestep-v15-turbo.safetensors"
exit 0
fi
echo "📥 Téléchargement du modèle ACE-Step 1.5 Turbo..."
echo "📦 Destination: $MODEL_DIR"
echo ""
echo "⏳ Le fichier fait environ 3-4GB, soyez patient..."
echo ""
# Télécharger le modèle
wget --progress=bar:force \
"https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/acestep-v15-turbo/model.safetensors" \
-O acestep-v15-turbo.safetensors
echo ""
echo "✅ Téléchargement terminé !"
echo ""
echo "📁 Fichier téléchargé :"
ls -lh acestep-v15-turbo.safetensors
echo ""
echo "================================"
echo "🎉 Prochaine étape :"
echo "1. Redémarrer ComfyUI: docker restart comfyui"
echo "2. Configurer le tool dans OpenWebUI"
echo "3. Tester avec un prompt musical !"
echo "================================"
+208
View File
@@ -0,0 +1,208 @@
# 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*