ACE-Step: AI Music Generation
Generate music tracks locally using ACE-Step 1.5. Runs locally on your own GPU.
When to use
Trigger on: "сгенерируй музыку", "сделай трек", "music generation", "ace-step", "напиши песню", "сгенерируй аудио", "background music", "soundtrack", "jingle"
Quick start
# Simple instrumental
cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "epic cinematic orchestral" --instrumental --duration 60
# Song with auto-generated lyrics
cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "upbeat pop song about coding" --generate-lyrics --duration 120
# Song with custom lyrics
cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "indie folk acoustic" --lyrics "[Verse 1]\nWalking down the road..." --duration 90
# Use XL model for better quality (slower, uses CPU offload)
cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "jazz piano trio" --model acestep-v15-xl-turbo --instrumental --duration 60
# Fast draft with no LM thinking
cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "techno beat" --no-thinking --instrumental --duration 30
Parameters
| Parameter |
Default |
Description |
caption |
required |
Music style/description prompt |
--lyrics |
"" |
Song lyrics (with [Verse], [Chorus] tags) |
--duration |
120 |
Length in seconds (10-600) |
--instrumental |
false |
No vocals |
--bpm |
auto |
Beats per minute |
--key |
auto |
Key/scale (e.g. "C major", "A minor") |
--language |
en |
Vocal language: en, zh, ja, ko, ru, etc |
--model |
auto |
DiT model (acestep-v15-turbo, acestep-v15-sft, acestep-v15-xl-turbo, acestep-v15-xl-sft) |
--seed |
-1 |
Random seed for reproducibility |
--steps |
auto |
Inference steps (more = better quality) |
--no-thinking |
false |
Skip LM (faster but lower quality) |
--generate-lyrics |
false |
Auto-generate lyrics from caption |
--config |
"" |
Use existing TOML config file |
--json |
false |
Output as JSON (for programmatic use) |
Models available
| Model |
Quality |
Speed (16GB) |
When to use |
| acestep-v15-turbo |
Good |
~5-10s |
Quick drafts, iteration |
| acestep-v15-sft |
Better |
~10-20s |
Default, balanced |
| acestep-v15-xl-turbo |
Great |
~20-40s |
Final renders (CPU offload) |
| acestep-v15-xl-sft |
Best |
~30-60s |
Production quality (CPU offload) |
Output
- Files saved to the user's Music folder, subdirectory
ace-step/. The script prints the
resolved absolute path on every run — read it, do not assume ~/Music.
- On a localized Linux the folder is named «Музыка»/«Musique», not
Music: the path is
taken from xdg-user-dir MUSIC. Override with ACE_STEP_OUTPUT_DIR=/where/you/want.
- Format: WAV (lossless)
- First run downloads model weights (~15-25 GB total from HuggingFace)
Lyrics format
[Verse 1]
First verse lyrics here
Second line of verse
[Chorus]
Chorus lyrics here
[Verse 2]
Second verse
[Bridge]
Bridge section
[Outro]
Final words
Caption prompt tips
Be specific about:
- Genre: "melodic death metal", "lo-fi hip hop", "orchestral film score"
- Instruments: "acoustic guitar, soft piano, ambient synths"
- Mood: "melancholic, introspective, building to triumphant"
- Vocals: "powerful female soprano", "raspy male baritone", "whispered"
- Tempo: "slow ballad", "high-energy 140 BPM"
- Reference: "in the style of Hans Zimmer film scores"
Gradio UI (alternative)
cd ~/your-ace-step && uv run acestep
# Opens http://127.0.0.1:7860
REST API (alternative)
cd ~/your-ace-step && uv run acestep-api
# REST API on http://127.0.0.1:8001
Architecture
- Location:
~/your-ace-step/
- Runtime: Python 3.12 via uv (isolated venv)
- GPU: your GPU, CPU offload (configure as needed) for XL models
- Tier: tier6a (16-20GB config)
- LM models: 0.6B, 1.7B (for lyrics gen and thinking)
1---2name: ace-step3description: "AI-музыка локально (ACE-Step 1.5, на своей видеокарте), CLI scripts/generate.py. Триггеры: «сгенерируй музыку», «сделай трек», «напиши песню». Всё локально, без облачных сервисов."4metadata:5 source: https://skillmd.com/skills/jhamidun/ace-step6---78# ACE-Step: AI Music Generation910Generate music tracks locally using ACE-Step 1.5. Runs locally on your own GPU.1112## When to use1314Trigger on: "сгенерируй музыку", "сделай трек", "music generation", "ace-step", "напиши песню", "сгенерируй аудио", "background music", "soundtrack", "jingle"1516## Quick start1718```bash19# Simple instrumental20cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "epic cinematic orchestral" --instrumental --duration 602122# Song with auto-generated lyrics23cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "upbeat pop song about coding" --generate-lyrics --duration 1202425# Song with custom lyrics26cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "indie folk acoustic" --lyrics "[Verse 1]\nWalking down the road..." --duration 902728# Use XL model for better quality (slower, uses CPU offload)29cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "jazz piano trio" --model acestep-v15-xl-turbo --instrumental --duration 603031# Fast draft with no LM thinking32cd ~/your-ace-step && uv run python ~/.claude/skills/ace-step/scripts/generate.py "techno beat" --no-thinking --instrumental --duration 3033```3435## Parameters3637| Parameter | Default | Description |38|-----------|---------|-------------|39| `caption` | required | Music style/description prompt |40| `--lyrics` | "" | Song lyrics (with [Verse], [Chorus] tags) |41| `--duration` | 120 | Length in seconds (10-600) |42| `--instrumental` | false | No vocals |43| `--bpm` | auto | Beats per minute |44| `--key` | auto | Key/scale (e.g. "C major", "A minor") |45| `--language` | en | Vocal language: en, zh, ja, ko, ru, etc |46| `--model` | auto | DiT model (acestep-v15-turbo, acestep-v15-sft, acestep-v15-xl-turbo, acestep-v15-xl-sft) |47| `--seed` | -1 | Random seed for reproducibility |48| `--steps` | auto | Inference steps (more = better quality) |49| `--no-thinking` | false | Skip LM (faster but lower quality) |50| `--generate-lyrics` | false | Auto-generate lyrics from caption |51| `--config` | "" | Use existing TOML config file |52| `--json` | false | Output as JSON (for programmatic use) |5354## Models available5556| Model | Quality | Speed (16GB) | When to use |57|-------|---------|-------------|-------------|58| **acestep-v15-turbo** | Good | ~5-10s | Quick drafts, iteration |59| **acestep-v15-sft** | Better | ~10-20s | Default, balanced |60| **acestep-v15-xl-turbo** | Great | ~20-40s | Final renders (CPU offload) |61| **acestep-v15-xl-sft** | Best | ~30-60s | Production quality (CPU offload) |6263## Output6465- Files saved to the user's Music folder, subdirectory `ace-step/`. The script prints the66 resolved absolute path on every run — read it, do not assume `~/Music`.67- On a localized Linux the folder is named «Музыка»/«Musique», not `Music`: the path is68 taken from `xdg-user-dir MUSIC`. Override with `ACE_STEP_OUTPUT_DIR=/where/you/want`.69- Format: WAV (lossless)70- First run downloads model weights (~15-25 GB total from HuggingFace)7172## Lyrics format7374```75[Verse 1]76First verse lyrics here77Second line of verse7879[Chorus]80Chorus lyrics here8182[Verse 2]83Second verse8485[Bridge]86Bridge section8788[Outro]89Final words90```9192## Caption prompt tips9394Be specific about:95- **Genre**: "melodic death metal", "lo-fi hip hop", "orchestral film score"96- **Instruments**: "acoustic guitar, soft piano, ambient synths"97- **Mood**: "melancholic, introspective, building to triumphant"98- **Vocals**: "powerful female soprano", "raspy male baritone", "whispered"99- **Tempo**: "slow ballad", "high-energy 140 BPM"100- **Reference**: "in the style of Hans Zimmer film scores"101102## Gradio UI (alternative)103104```bash105cd ~/your-ace-step && uv run acestep106# Opens http://127.0.0.1:7860107```108109## REST API (alternative)110111```bash112cd ~/your-ace-step && uv run acestep-api113# REST API on http://127.0.0.1:8001114```115116## Architecture117118- **Location**: `~/your-ace-step/`119- **Runtime**: Python 3.12 via uv (isolated venv)120- **GPU**: your GPU, CPU offload (configure as needed) for XL models121- **Tier**: tier6a (16-20GB config)122- **LM models**: 0.6B, 1.7B (for lyrics gen and thinking)