ACE-step

ACE-Step, a novel open-source foundation model for music generation.

Installation

Last Update 30.05.2025

MacOS > 15.1 and minimum M1 processor. See website and github for other systems.

Create Environment

using conda (recommended) or venv:

# create conda environment

conda create -n ace_step python=3.10 -y

# activate the new environment

conda activate ace_step 

#clone repository

git clone https://github.com/ace-step/ACE-Step.git && cd ACE-Step

# install pyTorch fitting your OS and system
# this currently installs pytorch version 2.7.0

pip3 install torch torchvision torchaudio

# test pyTorch installation using python3 and check mps availability:

python3 

import torch 
print("PyTorch version:", torch.__version__)
print("MPS available:", torch.backends.mps.is_available())
exit()

# Install ACE-step

pip install -e .

# launch ACE-step app from ACE-step directory:

cd ~/ACE-step

conda activate ace-step
acestep --port 7865 --bf16 false --share false

# !!! on MAC use `--bf16 false` to avoid errors !!!
# set --share true to make the editor public

# starting up can take some time...
# then open: http://127.0.0.1:7865 in browser.


# Advanced startup options:

acestep --checkpoint_path /path/to/checkpoint --port 7865 --device_id 0 --share true --bf16 false

# If `--checkpoint_path` is not set, auto download models to the default path `~/.cache/ace-step/checkpoints`.