How to install fspecii/ace-step-ui. Official installation instructions. Project installation guide. Framework or library installation. Build installation instructions. How to setup and install from GitHub. Installation steps and setup instructions. Official docs and installation instructions GitHub.
fspecii/ace-step-ui Installation Guide
How to install fspecii/ace-step-ui. Official project installation instructions and setup guide.
⚡
Automated Install (Recommended)
Quick installation instructions for fspecii/ace-step-ui. This is the fastest way to complete project installation and setup.
Install via curl
curl -fsSL https://hexmos.com/ipm-install | bash &&
ipm i fspecii/ace-step-uior
Install via npx
npx @hexmos/ipm i fspecii/ace-step-uiPrerequisites
Node.js
runtimeVersion: 18 or higher
Python
runtimeVersion: 3.10+
NVIDIA GPU
hardwareVersion: 4GB+ VRAM (8GB+ recommended for full features)
CUDA
driverVersion: 12.8 (for Windows Portable Package)
FFmpeg
dependencyVersion: Latest
uv
package managerVersion: Recommended for standard install
Manual Installation Methods
Manual installation instructions. How to install from GitHub source.
Pinokio - 1-Click Install (Recommended)
Install with Pinokio: https://beta.pinokio.co/apps/github-com-cocktailpeanut-ace-step-ui-pinokioWindows - One-Click Start
cd ace-step-ui
start-all.batLinux / macOS - One-Click Start
cd ace-step-ui
./start-all.shWindows - Manual Start (ACE-Step 1.5 Portable)
cd C:\ACE-Step-1.5
python_embeded\python -m acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1
cd ace-step-ui
start.batLinux / macOS - Manual Start
cd /path/to/ACE-Step-1.5
uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1
cd ace-step-ui
./start.shWindows - Standard Installation (ACE-Step 1.5)
cd C:\path\to\ACE-Step-1.5
uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1
cd ace-step-ui
start.batInstall ACE-Step (AI Engine) - Windows Portable Package
Download ACE-Step-1.5.7z from https://files.acemusic.ai/acemusic/win/ACE-Step-1.5.7z
Extract to C:\ACE-Step-1.5Install ACE-Step (AI Engine) - Standard Installation
git clone https://github.com/ace-step/ACE-Step-1.5
cd ACE-Step-1.5
uv venv
uv pip install -e .
cd ..Install ACE-Step UI - Linux / macOS
git clone https://github.com/fspecii/ace-step-ui
cd ace-step-ui
./setup.shInstall ACE-Step UI - Windows
git clone https://github.com/fspecii/ace-step-ui
cd ace-step-ui
setup.batInstall ACE-Step UI - Manual Installation
git clone https://github.com/fspecii/ace-step-ui
cd ace-step-ui
npm install
cd server
npm install
cd ..
cp server/.env.example server/.envPost Installation Steps
- Open http://localhost:3000 in your browser.
- Ensure ACE-Step Gradio server is running with --enable-api flag.
- Configure ACESTEP_API_URL in server/.env if ACE-Step is not running on http://localhost:8001.
