| --- |
| 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. |
|
|
