Folzo
982ec160ca
- 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
202 lines
4.5 KiB
Markdown
202 lines
4.5 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
docker restart comfyui
|
|
```
|
|
|
|
Attendre ~30 secondes puis vérifier :
|
|
```bash
|
|
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
|
|
|
|
```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
|
|
```
|
|
|
|
---
|
|
|
|
## 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](https://ace-step.github.io/)
|
|
- [ComfyUI ACE Workflows](https://comfyanonymous.github.io/ComfyUI_examples/)
|
|
- [JK-AceStep-Nodes](https://github.com/jeankassio/JK-AceStep-Nodes)
|
|
|
|
---
|
|
|
|
*Document créé: Avril 2026*
|