Folzo/Effi
Public Access
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: update ACE-Step documentation and scripts

Browse Source 
- docs/guide-ace-step.md: Complete installation guide
- comfyui/download-ace-step.sh: Download script for all ACE-Step models
- comfyui/docker-compose.yml: Add diffusion_models and text_encoders mounts

Includes:
- ace_step_1.5_turbo_aio.safetensors (~9.4GB)
- qwen_0.6b_ace15.safetensors
- qwen_1.7b_ace15.safetensors
- ace_1.5_vae.safetensors
This commit is contained in:
Folzo
2026-04-08 23:30:21 +02:00
parent 2c46c45a64
commit 982ec160ca
3 changed files with 185 additions and 162 deletions
Download Patch File Download Diff File Expand all files Collapse all files
comfyui/docker-compose.yml
+2
View File
@@ -13,6 +13,8 @@ services:
- ./models/checkpoints:/root/ComfyUI/models/checkpoints:Z - ./models/checkpoints:/root/ComfyUI/models/checkpoints:Z
- ./models/vae:/root/ComfyUI/models/vae:Z - ./models/vae:/root/ComfyUI/models/vae:Z
- ./models/loras:/root/ComfyUI/models/loras:Z - ./models/loras:/root/ComfyUI/models/loras:Z
- ./models/diffusion_models:/root/ComfyUI/models/diffusion_models:Z
- ./models/text_encoders:/root/ComfyUI/models/text_encoders:Z
- ./output:/root/ComfyUI/output:Z - ./output:/root/ComfyUI/output:Z
- ./input:/root/ComfyUI/input:Z - ./input:/root/ComfyUI/input:Z
- ./custom_nodes:/root/ComfyUI/custom_nodes:Z - ./custom_nodes:/root/ComfyUI/custom_nodes:Z
comfyui/download-ace-step.sh
+68 -40
View File
@@ -1,57 +1,85 @@
#!/bin/bash #!/bin/bash
# Script de téléchargement ACE-Step 1.5 Turbo # Script de téléchargement des modèles ACE-Step 1.5 pour ComfyUI
# Usage: bash download-ace-step.sh # Usage: bash download-ace-step.sh
set -e set -e
MODEL_DIR="/home/folzo/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step" BASE_DIR="$HOME/ace-models"
COMFYUI_DIR="$HOME/Documents/OpenCode/Projets/Effi/comfyui/models"
echo "🎵 ACE-Step 1.5 Turbo - Téléchargement" echo "🎵 ACE-Step 1.5 - Téléchargement des modèles"
echo "================================" echo "=============================================="
echo "" echo ""
# Créer le dossier si nécessaire # Créer le dossier de téléchargement
mkdir -p "$MODEL_DIR" mkdir -p "$BASE_DIR"
cd "$BASE_DIR"
# Vérifier si wget est disponible # 1. ace_step_1.5_turbo_aio (modèle principal AIO)
if ! command -v wget &> /dev/null; then echo "📦 1/4 - Téléchargement ace_step_1.5_turbo_aio (~9.4GB)..."
echo "❌ wget non trouvé. Installation..." if [ ! -f "ace_step_1.5_turbo_aio.safetensors" ]; then
sudo apt update && sudo apt install wget curl -L --progress-bar \
"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"
echo "✅ Téléchargé"
else
echo "✅ Déjà présent"
fi fi
ls -lh ace_step_1.5_turbo_aio.safetensors 2>/dev/null || echo "Fichier non trouvé"
cd "$MODEL_DIR" echo ""
# Vérifier si le modèle existe déjà # 2. qwen_0.6b_ace15 (text encoder)
if [ -f "acestep-v15-turbo.safetensors" ]; then echo "📦 2/4 - Téléchargement qwen_0.6b_ace15 (~1.2GB)..."
echo "✅ Le modèle existe déjà :" if [ ! -f "qwen_0.6b_ace15.safetensors" ]; then
ls -lh acestep-v15-turbo.safetensors curl -L --progress-bar \
echo "" "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/Qwen3-Embedding-0.6B/model.safetensors" \
echo "Pour re-télécharger, supprimez d'abord le fichier :" -o "qwen_0.6b_ace15.safetensors"
echo "rm $MODEL_DIR/acestep-v15-turbo.safetensors" echo "✅ Téléchargé"
exit 0 else
echo "✅ Déjà présent"
fi fi
ls -lh qwen_0.6b_ace15.safetensors 2>/dev/null || echo "Fichier non trouvé"
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 ""
echo "✅ Téléchargement terminé !"
echo "" # 3. qwen_1.7b_ace15 (text encoder)
echo "📁 Fichier téléchargé :" echo "📦 3/4 - Téléchargement qwen_1.7b_ace15 (~3.5GB)..."
ls -lh acestep-v15-turbo.safetensors if [ ! -f "qwen_1.7b_ace15.safetensors" ]; then
curl -L --progress-bar \
"https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/acestep-5Hz-lm-1.7B/model.safetensors" \
-o "qwen_1.7b_ace15.safetensors"
echo "✅ Téléchargé"
else
echo "✅ Déjà présent"
fi
ls -lh qwen_1.7b_ace15.safetensors 2>/dev/null || echo "Fichier non trouvé"
echo "" echo ""
echo "================================"
echo "🎉 Prochaine étape :" # 4. ace_1.5_vae (VAE)
echo "1. Redémarrer ComfyUI: docker restart comfyui" echo "📦 4/4 - Téléchargement ace_1.5_vae (~322MB)..."
echo "2. Configurer le tool dans OpenWebUI" if [ ! -f "ace_1.5_vae.safetensors" ]; then
echo "3. Tester avec un prompt musical !" curl -L --progress-bar \
echo "================================" "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/vae/diffusion_pytorch_model.safetensors" \
-o "ace_1.5_vae.safetensors"
echo "✅ Téléchargé"
else
echo "✅ Déjà présent"
fi
ls -lh ace_1.5_vae.safetensors 2>/dev/null || echo "Fichier non trouvé"
echo ""
echo "=============================================="
echo "📁 Fichiers téléchargés dans: $BASE_DIR"
ls -lh *.safetensors 2>/dev/null
echo ""
echo "=============================================="
echo "⚠️ Étape suivante : Copier vers ComfyUI"
echo ""
echo "sudo cp *.safetensors $COMFYUI_DIR/checkpoints/"
echo "sudo cp ace_1.5_vae.safetensors $COMFYUI_DIR/vae/"
echo ""
echo "Puis redémarrer ComfyUI:"
echo "docker restart comfyui"
echo "=============================================="
docs/guide-ace-step.md
+115 -122
View File
@@ -1,123 +1,140 @@
# Guide Installation ACE-Step 1.5 - Génération de Musique # 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. Ce guide explique comment installer et utiliser ACE-Step 1.5 pour générer de la musique avec ComfyUI et OpenWebUI.
--- ---
## Prérequis ## 📋 Résumé
- ✅ ComfyUI installé sur Folzo Corp (192.168.1.11:8188) ACE-Step 1.5 est un modèle de génération musicale open-source :
- ✅ Custom node ACE-Step installé - **License**: MIT (commercial OK)
- ✅ RX 7800 XT 16GB VRAM - **VRAM**: < 4GB (fonctionne sur RX 7800 XT 16GB)
- ✅ ~5GB d'espace libre - **Langues**: 50+ dont Français
- **Durée**: Jusqu'à 10 minutes par chanson
- **Temps de génération**: ~10 secondes sur GPU
--- ---
## ÉTAPE 1 : Vérifier le custom node ACE-Step ## MODÈLES REQUIS
Sur **Folzo Corp**, vérifier que le custom node ACE-Step est installé : ### Fichiers à télécharger
```bash | Modèle | Taille | Emplacement |
ls -la ~/Documents/OpenCode/Projets/Effi/comfyui/custom_nodes/ |--------|--------|-------------|
``` | `ace_step_1.5_turbo_aio.safetensors` | ~9.4GB | `models/checkpoints/` |
| `qwen_0.6b_ace15.safetensors` | ~1.2GB | `models/checkpoints/` |
Tu dois voir un dossier type `ComfyUI-ACE-Step-Audio` ou similaire. | `qwen_1.7b_ace15.safetensors` | ~3.5GB | `models/checkpoints/` |
| `ace_1.5_vae.safetensors` | ~322MB | `models/vae/` |
--- ---
## ÉTAPE 2 : Télécharger le modèle ACE-Step 1.5 ## ÉTAPE 1 : Télécharger les modèles
### 2.1 : Créer le dossier ### 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
```bash ```bash
mkdir -p ~/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step # Sur Folzo Corp
``` mkdir -p ~/ace-models
cd ~/ace-models
### 2.2 : Télécharger le modèle # 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
```bash # Télécharger les text encoders
cd ~/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step curl -L "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/Qwen3-Embedding-0.6B/model.safetensors" \
-o qwen_0.6b_ace15.safetensors
wget "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/acestep-v15-turbo/model.safetensors" \ curl -L "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/acestep-5Hz-lm-1.7B/model.safetensors" \
-O acestep-v15-turbo.safetensors -o qwen_1.7b_ace15.safetensors
```
Le fichier fait environ **3-4GB**, ça peut prendre du temps. # Copier vers ComfyUI (besoin sudo)
sudo cp *.safetensors /home/folzo/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/
### 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 ## ÉTAPE 2 : Redémarrer ComfyUI
```bash ```bash
docker restart comfyui docker restart comfyui
``` ```
Attendre 30 secondes, puis vérifier : Attendre ~30 secondes puis vérifier :
```bash ```bash
curl http://localhost:8188/system_stats curl http://localhost:8188/system_stats
``` ```
--- ---
## ÉTAPE 4 : Configurer le Tool dans OpenWebUI ## ÉTAPE 3 : Charger le workflow ACE-Step
### 4.1 : Ouvrir OpenWebUI 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
Dans ton navigateur : http://192.168.1.27:3000 ### Si des modèles sont manquants (surlignés en rouge) :
### 4.2 : Aller dans Admin Panel 1. Cliquer sur le nœud **DualCLIPLoader**
2. Sélectionner :
- `clip_name1` : `qwen_0.6b_ace15.safetensors`
- `clip_name2` : `qwen_1.7b_ace15.safetensors`
Clique sur ton **profil** (en bas à gauche) → **Admin Panel** 3. Cliquer sur **Queue Prompt**
### 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 ## ÉTAPE 4 : Configurer le Tool OpenWebUI
### 5.1 : Test via OpenWebUI ### 4.1 : Vérifier le custom node JK-AceStep
1. Ouvre une conversation avec Effi Le tool "Generate Song" d'OpenWebUI nécessite le custom node **JK-AceStep-Nodes**.
2. Active le tool **Generate Song**
3. Tape un prompt comme :
``` Dans ComfyUI :
Génère une chanson "electro, synthwave" sur le thème "voyage dans l'espace", durée 60 secondes 1. **Manager** → **Install Custom Nodes**
``` 2. Chercher **"JK-AceStep-Nodes"**
3. Installer et redémarrer
### 5.2 : Test via ComfyUI directement ### 4.2 : Configurer le tool
1. Ouvre http://192.168.1.11:8188 1. Ouvrir http://192.168.1.27:3000
2. Charge le workflow ACE-Step 2. **Admin Panel** → **Tools**
3. Clique **Queue Prompt** 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`
--- ---
## Commandes Utiles ## É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
```bash ```bash
# Voir les logs ComfyUI # Voir les logs ComfyUI
@@ -135,73 +152,49 @@ df -h
--- ---
## Dépannage ## EXEMPLES DE PROMPTS
### 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
``` ```
# Rock energique
"pop, actuel, amour, sentimental, rythmé"
# Electro synthwave # Electro synthwave
"Generate an 80s synthwave song about neon cities" "electro, synthwave, 80s, neon"
# Rock metal # Metal
"Generate a heavy metal song about dragons and fantasy" "heavy metal, dragons, fantasy, powerful"
# French song # Française
"Génère une chanson française, style chanson réaliste, sur l'amour perdu" "chanson française, réaliste, amour perdu, emotif"
# Chill ambient
"Generate a chill ambient track, relaxing, nature sounds"
``` ```
--- ---
## Informations sur le Modèle ## DÉPANNAGE
| Caractéristique | Valeur | ### "No audio files generated"
|-----------------|--------|
| **Nom** | ACE-Step 1.5 Turbo | - Vérifier que le custom node JK-AceStep est installé
| **License** | MIT (commercial OK) | - Vérifier que tous les modèles sont dans ComfyUI
| **VRAM** | < 4GB | - Redémarrer ComfyUI
| **Langues** | 50+ dont Français |
| **Durée max** | 10 minutes | ### "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
--- ---
## Pour Aller Plus Loin ## LIENS UTILES
### Personnaliser le Workflow - [ACE-Step Official](https://ace-step.github.io/)
- [ComfyUI ACE Workflows](https://comfyanonymous.github.io/ComfyUI_examples/)
Tu peux modifier le workflow ACE-Step dans ComfyUI pour : - [JK-AceStep-Nodes](https://github.com/jeankassio/JK-AceStep-Nodes)
- 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.
--- ---