ACE-Step
Aplicación Docker from SpaceInvaderOne's Repository
Visión general
ACE-Step 1.5 - AI Music Generation. Generate full songs with vocals, instrumentals, and lyrics using a Diffusion Transformer. Supports text-to-music, remixing, cover generation, and LoRA fine-tuning. Requires NVIDIA GPU with CUDA support.
FIRST RUN: Models (~10GB) will be downloaded automatically on first start. This may take several minutes depending on your internet speed. Subsequent starts are instant.
SETTINGS GUIDE:
DiT Model - The core music generation model.
- turbo (default): Fast generation in 8 steps. Best for most users.
- turbo-rl: Turbo with reinforcement learning refinement.
- sft: Higher quality, 50 steps (slower).
- base: 50 steps with all features (extract, lego, complete).
Language Model - Controls lyrics understanding and chain-of-thought reasoning.
- 1.7B (default): Best balance of quality and VRAM. Recommended for 12-16GB GPUs.
- 0.6B: For GPUs with less than 12GB VRAM.
- 4B: Highest quality lyrics understanding. Requires 24GB+ VRAM.
Enable LLM - Whether to load the language model.
- auto (default): Detects based on your GPU VRAM.
- false: DiT-only mode. Faster startup, uses less VRAM, but disables thinking/sample features.
- true: Force enable.
LM Backend - Engine for the language model.
- pt (default): PyTorch native. Works on all GPUs including RTX 50-series.
- vllm: Faster inference but may crash on RTX 50-series (Blackwell) GPUs.
CPU Offloading - Moves models between GPU and CPU to save VRAM.
- auto (default): Offloads if GPU has less than 20GB VRAM.
- false: Keep all models on GPU. Faster generation but uses ~12GB VRAM at idle.
- true: Always offload. Slower but frees VRAM for other containers.
UI Language - Web interface language: English, Chinese, or Japanese.
Requisitos
Argumentos en tiempo de ejecución
- Interfaz web
http://[IP]:[PORT:7860]/- Red
bridge- Concha
bash- Privilegiado
- false
- Parámetros adicionales
--gpus all --user root
Configuración de plantillas
Gradio Web UI and REST API port
- Objetivo
- 7860
- Por defecto
- 7860
- Valor
- 7860
AI model files (~10GB, auto-downloaded on first run)
- Objetivo
- /app/checkpoints
- Por defecto
- /mnt/user/appdata/ace-step/checkpoints
- Valor
- /mnt/user/appdata/ace-step/checkpoints
Generated music files output directory
- Objetivo
- /app/gradio_outputs
- Por defecto
- /mnt/user/appdata/ace-step/output
- Valor
- /mnt/user/appdata/ace-step/output
Diffusion model variant. Turbo=8 steps (fast), SFT=50 steps (quality), Base=50 steps (all features including extract/lego/complete).
- Objetivo
- ACESTEP_CONFIG_PATH
- Por defecto
- acestep-v15-turbo|acestep-v15-turbo-rl|acestep-v15-sft|acestep-v15-base
- Valor
- acestep-v15-turbo
Chain-of-thought LM size. 1.7B recommended for 16GB VRAM. 4B needs 24GB+. 0.6B for low VRAM.
- Objetivo
- ACESTEP_LM_MODEL_PATH
- Por defecto
- acestep-5Hz-lm-1.7B|acestep-5Hz-lm-0.6B|acestep-5Hz-lm-4B
- Valor
- acestep-5Hz-lm-1.7B
Auto detects based on GPU VRAM. Set false for DiT-only mode (faster, no thinking/sample features).
- Objetivo
- ACESTEP_INIT_LLM
- Por defecto
- auto|true|false
- Valor
- auto
pt (PyTorch native) is recommended for RTX 50-series. vllm (nano-vllm) is faster but may segfault on Blackwell GPUs.
- Objetivo
- ACESTEP_LM_BACKEND
- Por defecto
- pt|vllm
- Valor
- pt
Web interface language
- Objetivo
- LANGUAGE
- Por defecto
- en|zh|ja
- Valor
- en
auto = ACE-Step decides based on VRAM (offloads below 20GB). false = keep all models on GPU (faster, needs ~12GB idle VRAM). true = offload models to CPU between steps (slower, saves VRAM for shared GPU use).
- Objetivo
- ACESTEP_OFFLOAD_CPU
- Por defecto
- auto|false|true
- Valor
- auto
Internal port for Gradio server (should match the port mapping above)
- Objetivo
- PORT
- Por defecto
- 7860
- Valor
- 7860
Default generation batch size (1-8). Leave empty for auto (min(2, GPU max)).
- Objetivo
- ACESTEP_BATCH_SIZE
Which GPU(s) to use. 0 = first GPU.
- Objetivo
- CUDA_VISIBLE_DEVICES
- Por defecto
- 0
- Valor
- 0
Model download source. Auto tries HuggingFace first, falls back to ModelScope.
- Objetivo
- ACESTEP_DOWNLOAD_SOURCE
- Por defecto
- auto|huggingface|modelscope
- Valor
- auto
Categorías
Descargar estadísticas
Detalles
spaceinvaderone/ace-step:latestEjecute ACE-Step en Unraid.
ACE-Step se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.