File size: 2,123 Bytes
622a840
 
 
 
3aa5eef
622a840
 
 
 
 
 
 
 
 
 
 
 
 
 
3aa5eef
622a840
3aa5eef
 
 
 
622a840
 
3aa5eef
622a840
3aa5eef
622a840
3aa5eef
 
 
622a840
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3aa5eef
 
622a840
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
---
license: mit
base_model:
  - ACE-Step/acestep-v15-xl-turbo
  - ACE-Step/acestep-v15-xl-sft
pipeline_tag: text-to-audio
tags:
  - gguf
  - ace-step
  - text-to-music
  - audio.cpp
---

# audio.cpp GGUF

GGUF conversions of music and speech models for
[audio.cpp](https://github.com/0xShug0/audio.cpp), the ggml-based native audio
inference framework.

## ACE-Step 1.5 XL (bf16)

| File | Size | Package | Upstream |
|---|---:|---|---|
| `ACE-Step1.5-GGUF/xl-turbo/ace-step-1.5-xl-turbo-bf16.gguf` | 14.2 GB | `ace_step_xl_turbo_bf16` | [acestep-v15-xl-turbo](https://huggingface.co/ACE-Step/acestep-v15-xl-turbo) |
| `ACE-Step1.5-GGUF/xl-sft/ace-step-1.5-xl-sft-bf16.gguf` | 14.2 GB | `ace_step_xl_sft_bf16` | [acestep-v15-xl-sft](https://huggingface.co/ACE-Step/acestep-v15-xl-sft) |

The XL DiT is the larger ACE-Step 1.5 transformer: 32 layers of 2560 against
turbo's 24 of 2048, with 32 attention heads of 128. Each file is self-contained
the way audio.cpp's other ACE-Step GGUFs are — XL DiT, planner LM, text encoder
and VAE in one file — so neither needs another download.

XL Turbo is guidance-distilled and ignores `guidance_scale`; XL SFT takes the
CFG path. Both were converted from the float32 upstream snapshots with
`audiocpp_gguf --type bf16`.

### Install

```bash
python tools/model_manager_v2.py install ace_step_xl_turbo_bf16
```

### Run

The DiT variant is a load option, so name it explicitly:

```bash
audiocpp_cli --task gen --family ace_step --model models/ACE-Step1.5-GGUF/xl-turbo \
  --backend cuda --task-route text2music \
  --text "warm lo-fi hip hop with a soft rhodes piano" --duration-seconds 60 \
  --load-option ace_step.dit_model_path=acestep-v15-xl-turbo --out song.wav
```

Measured on an RTX 5090 (CUDA), 20 s of audio in 15 s including model load,
either variant.

XL support landed in audio.cpp via
[PR #235](https://github.com/0xShug0/audio.cpp/pull/235); see
`docs/models/ace_step.md` there for the full option reference and for rebuilding
this file yourself.

Weights are MIT-licensed by ACE-Step; this repository only redistributes them in
a different container format.