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/vae:/root/ComfyUI/models/vae: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
- ./input:/root/ComfyUI/input:Z
- ./custom_nodes:/root/ComfyUI/custom_nodes:Z
comfyui/download-ace-step.sh
+68 -40
View File
@@ -1,57 +1,85 @@
#!/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
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 "================================"
echo "🎵 ACE-Step 1.5 - Téléchargement des modèles"
echo "=============================================="
echo ""
# Créer le dossier si nécessaire
mkdir -p "$MODEL_DIR"
# Créer le dossier de téléchargement
mkdir -p "$BASE_DIR"
cd "$BASE_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
# 1. ace_step_1.5_turbo_aio (modèle principal AIO)
echo "📦 1/4 - Téléchargement ace_step_1.5_turbo_aio (~9.4GB)..."
if [ ! -f "ace_step_1.5_turbo_aio.safetensors" ]; then
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
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à
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
# 2. qwen_0.6b_ace15 (text encoder)
echo "📦 2/4 - Téléchargement qwen_0.6b_ace15 (~1.2GB)..."
if [ ! -f "qwen_0.6b_ace15.safetensors" ]; then
curl -L --progress-bar \
"https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/Qwen3-Embedding-0.6B/model.safetensors" \
-o "qwen_0.6b_ace15.safetensors"
echo "✅ Téléchargé"
else
echo "✅ Déjà présent"
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
ls -lh qwen_0.6b_ace15.safetensors 2>/dev/null || echo "Fichier non trouvé"
echo ""
echo "✅ Téléchargement terminé !"
echo ""
echo "📁 Fichier téléchargé :"
ls -lh acestep-v15-turbo.safetensors
# 3. qwen_1.7b_ace15 (text encoder)
echo "📦 3/4 - Téléchargement qwen_1.7b_ace15 (~3.5GB)..."
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 "🎉 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 "================================"
# 4. ace_1.5_vae (VAE)
echo "📦 4/4 - Téléchargement ace_1.5_vae (~322MB)..."
if [ ! -f "ace_1.5_vae.safetensors" ]; then
curl -L --progress-bar \
"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
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)
- ✅ Custom node ACE-Step installé
- ✅ RX 7800 XT 16GB VRAM
- ✅ ~5GB d'espace libre
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
---
## É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
ls -la ~/Documents/OpenCode/Projets/Effi/comfyui/custom_nodes/
```
Tu dois voir un dossier type `ComfyUI-ACE-Step-Audio` ou similaire.
| 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 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
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
cd ~/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/ace-step
# 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
wget "https://huggingface.co/ACE-Step/Ace-Step1.5/resolve/main/acestep-v15-turbo/model.safetensors" \
-O acestep-v15-turbo.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
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/
# Copier vers ComfyUI (besoin sudo)
sudo cp *.safetensors /home/folzo/Documents/OpenCode/Projets/Effi/comfyui/models/checkpoints/
```
---
## ÉTAPE 3 : Redémarrer ComfyUI
## ÉTAPE 2 : Redémarrer ComfyUI
```bash
docker restart comfyui
```
Attendre 30 secondes, puis vérifier :
Attendre ~30 secondes puis vérifier :
```bash
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**
### 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**
3. Cliquer sur **Queue Prompt**
---
## É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
2. Active le tool **Generate Song**
3. Tape un prompt comme :
Le tool "Generate Song" d'OpenWebUI nécessite le custom node **JK-AceStep-Nodes**.
```
Génère une chanson "electro, synthwave" sur le thème "voyage dans l'espace", durée 60 secondes
```
Dans ComfyUI :
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
2. Charge le workflow ACE-Step
3. Clique **Queue Prompt**
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`
---
## 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
# Voir les logs ComfyUI
@@ -135,73 +152,49 @@ 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
## EXEMPLES DE PROMPTS
```
# Rock energique
"pop, actuel, amour, sentimental, rythmé"
# Electro synthwave
"Generate an 80s synthwave song about neon cities"
"electro, synthwave, 80s, neon"
# Rock metal
"Generate a heavy metal song about dragons and fantasy"
# Metal
"heavy metal, dragons, fantasy, powerful"
# 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"
# Française
"chanson française, réaliste, amour perdu, emotif"
```
---
## Informations sur le Modèle
## DÉPANNAGE
| 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 |
### "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
---
## Pour Aller Plus Loin
## LIENS UTILES
### 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.
- [ACE-Step Official](https://ace-step.github.io/)
- [ComfyUI ACE Workflows](https://comfyanonymous.github.io/ComfyUI_examples/)
- [JK-AceStep-Nodes](https://github.com/jeankassio/JK-AceStep-Nodes)
---