# ACE-Step

**Repository Path**: alan-ding/ACE-Step

## Basic Information

- **Project Name**: ACE-Step
- **Description**: 我们介绍ACE-Step，一种全新的开源音乐生成基础模型，克服了现有方法的关键局限，并通过整体架构设计实现了最先进的性能。现有方法在生成速度、音乐一致性和可控性之间存在固有权衡。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-27
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ACE-Step

[ACE-Step](https://gitee.com/JonDO/ACE-Step)

## Installation

### Prerequisites

Install global modules first:

```bash
# Install from global-requirements.txt
# (See global-requirements.txt for the list of required packages)
```

### Setup Steps

1. **Initialize the project**

```bash
uv sync
```

2. **Enable global CUDA PyTorch**

Modify `.venv\pyvenv.cfg`:

```ini
include-system-site-packages = true
```

3. **Remove venv torch to use global one**

Remove the torch package from the virtual environment to use the globally installed version.

4. **Install the package**

```bash
uv pip install -e .
```

5. **Remove all `show_download_button`**

Remove all occurrences of `show_download_button` parameter from the codebase (Gradio compatibility fix).

![Remove show_download_button](image-1.png)

6. **Set default checkpoint path**

Configure the default checkpoint path in the settings.

![Set checkpoint path](image.png)

7. **Start the application**

```bash
acestep --port 7865
```

The web UI will be available at `http://127.0.0.1:7865`

8. **update save audio**
![alt text](image-2.png)


## test 
![alt text](image-3.png)
![alt text](image-4.png)


## mcp server
![alt text](image-5.png)

## agent use
![alt text](image-6.png)