From 2c46c45a64454504b383580d894ac3cd83d9c8ba Mon Sep 17 00:00:00 2001 From: Folzo Date: Wed, 8 Apr 2026 22:20:54 +0200 Subject: [PATCH] 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 --- comfyui/custom_nodes/ComfyUI-Unload-Model | 1 + comfyui/download-ace-step.sh | 57 ++++++ docs/guide-ace-step.md | 208 ++++++++++++++++++++++ 3 files changed, 266 insertions(+) create mode 160000 comfyui/custom_nodes/ComfyUI-Unload-Model create mode 100755 comfyui/download-ace-step.sh create mode 100644 docs/guide-ace-step.md diff --git a/comfyui/custom_nodes/ComfyUI-Unload-Model b/comfyui/custom_nodes/ComfyUI-Unload-Model new file mode 160000 index 0000000..ac5ffb4 --- /dev/null +++ b/comfyui/custom_nodes/ComfyUI-Unload-Model @@ -0,0 +1 @@ +Subproject commit ac5ffb4ed05546545ce7cf38e7b69b5152714eed diff --git a/comfyui/download-ace-step.sh b/comfyui/download-ace-step.sh new file mode 100755 index 0000000..28541af --- /dev/null +++ b/comfyui/download-ace-step.sh @@ -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 "================================" diff --git a/docs/guide-ace-step.md b/docs/guide-ace-step.md new file mode 100644 index 0000000..9b32bc2 --- /dev/null +++ b/docs/guide-ace-step.md @@ -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*