Install ACE-Step v1.5 (2B) locally
This guide focuses on reliable, repeatable installation for the ace step1.5 model. It emphasizes environment isolation, predictable dependencies, and clean model management. While the exact commands depend on your preferred stack, the structure below keeps you out of dependency conflicts and makes future updates smoother.
Installation checklist
- Verify GPU drivers and CUDA or ROCm support if applicable.
- Create a fresh environment (venv, conda, or poetry).
- Install the ACE-Step v1.5 runtime dependencies.
- Download the model weights into a dedicated models folder.
- Run a short test generation to confirm audio output.
Recommended folder structure
Keeping your workspace organized helps you track versions and avoid accidental overwrites. A typical structure includes a root project folder, a models directory, a prompts library, and an outputs folder. This makes it easier to export your best clips and reuse your favorite settings.
First run sanity checks
- Confirm your model path resolves correctly.
- Run a short 5 to 10 second clip at modest settings.
- Check for artifacts or silence in the output file.
- Log the prompt and seed for reproducibility.
If the model fails to load or your GPU runs out of memory, jump to the troubleshooting page or adjust your settings. Ace step 1.5 is flexible and can be tuned to fit a wide range of hardware.