ace-step-ui

环境要求

• Python 环境与 uv 包管理器（用于安装 ACE-Step 1.5 引擎）
• Node.js 与 npm（用于安装前端与服务端依赖）
• 支持 pt 后端的 GPU，用于 ACE-Step 模型推理
• 约 5GB 以上磁盘空间，模型首次运行会自动下载
• Windows 用户可直接使用 start.bat 启动界面

安装与启动步骤

1. 1一键安装(可选)

   访问 Pinokio 应用页点击安装，自动处理 Python、Node.js、依赖与模型下载，适合所有平台新手。

2. 2安装 ACE-Step 引擎

   在 ACE-Step-1.5 目录创建虚拟环境并安装依赖；模型首次运行会自动下载约 5GB。

   uv venv
   uv pip install -e .

   复制

3. 3启动 ACE-Step 后端

   在同一目录启动 Gradio 服务并开启 API，监听 127.0.0.1:8001，UI 需要连接该端口。

   uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1

   复制

4. 4安装 UI 依赖

   在 ace-step-ui 目录运行 setup.sh，自动安装前后端全部依赖。

   ./setup.sh

   复制

5. 5手动安装依赖(可选)

   若 setup.sh 不可用，先装前端依赖，再进入 server 目录安装服务端依赖后返回。

   npm install
   cd server
   npm install
   cd ..

   复制

6. 6启动 UI

   Windows 下在 ace-step-ui 目录执行 start.bat 启动界面，需保持 ACE-Step 后端已运行。

   cd ace-step-ui
   start.bat

   复制

7. 7打开界面

   浏览器访问 http://localhost:3000 即可开始生成音乐。

如何确认成功

浏览器打开 http://localhost:3000 能看到界面，且 8001 端口后端已运行即为成功。

常见问题

注意事项

• README 节选未列出 server/.env 的具体配置项，配置前请查看仓库内该文件
• 首次运行会自动下载约 5GB 模型，请预留磁盘空间与下载时间
• ACE-Step 后端与 UI 需要在两个不同的终端中分别运行
• README 未提供在 ACE-Step-1.5 目录之外的具体克隆命令，请先准备好该目录