<div align="center"> <img src="docs/assets/banner.png" alt="AceDeck — the desktop studio for ACE-Step 1.5" width="100%" />

AceDeck

The desktop studio & control deck for ACE-Step 1.5 — generate full songs with vocals locally on your own GPU. Now with a Wan 2.1 video studio.

One-click install · Generation queue & batches · Cover / Repaint / Stems · Text-to-video · Engine control · Stability check · Claude MCP

English · Русский

⬇ Download for Windows  ·  Features  ·  Screenshots  ·  Claude MCP  ·  FAQ

</div>

---

ACE-Step 1.5 is one of the best open music generation models — a local, free alternative to Suno and Udio. But out of the box it is a Python repo, a Gradio page and a REST API. AceDeck turns it into a real desktop app: it installs the model and all dependencies with one button, starts/stops/restarts the inference server for you, lets you queue dozens of songs, shows live progress, keeps a searchable library of everything you generated and can even check whether your setup runs stably. Claude can drive all of it through the bundled MCP server.

<div align="center"> <img src="docs/screenshots/en/create.png" alt="AceDeck — Create page" width="92%" /> </div>

✨ Features

| | | |---|---| | 🎹 Full ACE-Step 1.5 studio | Simple mode (describe the song in any language — AceDeck turns it into the English style caption ACE-Step understands, shows what the engine will hear and keeps your genre with Exact style; the LM writes the lyrics), Custom mode (style tags + lyrics with [Verse]/[Chorus] helpers), Cover / remix, Repaint a section, Stems (extract / add / complete tracks). Every engine parameter is exposed: duration, BPM, key, time signature, vocal language, DiT & LM model, thinking, steps, guidance, seed, sampler, shift, ADG, CFG interval, LM temperature/CFG/top-k/top-p, negative prompt, output format (MP3/FLAC/WAV/Opus/AAC). | | 🎬 Video studio ^new | Text-to-video with Wan 2.1 rendered by a local ComfyUI that AceDeck installs (ComfyUI + PyTorch CUDA + ~10 GB of Wan models, one click), starts and feeds. Size presets, 1–7 s clips, steps / CFG / shift / sampler, negative prompt, up to 4 LoRAs, several clips per job with their own seeds, a video queue with live frame progress and ETA, and a Clips gallery with player. Add community Wan 2.1 1.3B fine-tunes and LoRAs by pasting a Hugging Face link. Music and video share one GPU: jobs take turns and the music engine is paused and restarted automatically when VRAM is short. | | ✍️ AI helpers | Write with AI turns an idea into caption, lyrics, tempo and key; Enhance polishes your lyrics; Surprise me fills in a random example. | | 📋 Generation queue | Queue any number of jobs, set how many songs each job should produce and how many are rendered per pass. Reorder, cancel, retry (resumes where it stopped), duplicate, pause. The queue survives restarts and parks itself if the engine goes down. | | 📈 Live progress | Progress ring with real engine stages (composing → planning melody → rendering → decoding), per-pass progress bar, ETA and the engine's live log line. | | 🎧 Library & player | Every song is saved to Music\AceDeck with a JSON sidecar (caption, lyrics, seed, BPM, key, model). Grid with generative cover art, search, favorites, waveform player with seeking, Save as…, Show in folder, Reuse settings, Make a cover, Repaint a part. | | ⚙️ Engine control | Start · Stop · Restart · Update (git pull + uv sync) the ACE-Step API server. Live GPU/VRAM, loaded models, uptime, port, PID and a filtered live log. Attaches to an engine that is already running. | | 🩺 Stability check | 16 checks across system, install, engine and a real stress test (several generations with timing, VRAM peak and leak detection) → verdict Stable / Unstable / Not working, score and a copyable report. | | 📦 One-click installer | Detects existing installs, or installs everything with progress bars per step: uv, ACE-Step source (git or zip), Python 3.12 + PyTorch CUDA 12.8, ~10 GB of models, config and a GPU self-test. Repair mode finishes partial installs. | | 🧠 Model manager | Download extra DiT models (SFT, Base, XL 4B, turbo variants) and LM planners (0.6B / 4B) with progress, pick the defaults. | | 🤖 Claude MCP | 12 MCP tools so Claude Desktop / Claude Code can generate songs, manage the queue, run diagnostics and control the engine. One click adds AceDeck to Claude Desktop. | | 🔌 Automation API | Token-protected local HTTP API (127.0.0.1) + scripts/ctl.mjs for your own scripts. | | 🔄 Updates in the app | AceDeck checks GitHub Releases on start, shows what's new and installs the new version in one click (Settings → Updates) — the portable build updates itself too. The installer puts an AceDeck icon on the desktop. | | 🌍 English & Русский | Full UI localization with proper plural forms; follows the system language. |

📸 Screenshots

<table> <tr> <td width="50%"><img src="docs/screenshots/en/queue.png" alt="Generation queue" /><p align="center"><b>Queue</b> — live progress, ETA, batches</p></td> <td width="50%"><img src="docs/screenshots/en/library.png" alt="Library" /><p align="center"><b>Library</b> — generative covers & waveform player</p></td> </tr> <tr> <td><img src="docs/screenshots/en/create-custom.png" alt="Custom mode" /><p align="center"><b>Custom mode</b> — lyrics, song & model settings</p></td> <td><img src="docs/screenshots/en/track.png" alt="Track details" /><p align="center"><b>Track details</b> — save, reuse, cover, repaint</p></td> </tr> <tr> <td><img src="docs/screenshots/en/engine.png" alt="Engine" /><p align="center"><b>Engine</b> — start / stop / restart / update</p></td> <td><img src="docs/screenshots/en/diagnostics.png" alt="Stability check" /><p align="center"><b>Stability check</b> — stress test & verdict</p></td> </tr> <tr> <td><img src="docs/screenshots/en/setup.png" alt="Installer" /><p align="center"><b>Install</b> — one click, or reuse an existing install</p></td> <td><img src="docs/screenshots/en/claude.png" alt="Claude & MCP" /><p align="center"><b>Claude & MCP</b> — one-click setup</p></td> </tr> <tr> <td><img src="docs/screenshots/en/models.png" alt="Models" /><p align="center"><b>Models</b> — download & choose defaults</p></td> <td><img src="docs/screenshots/en/settings.png" alt="Settings" /><p align="center"><b>Settings</b></p></td> </tr> <tr> <td><img src="docs/screenshots/en/video.png" alt="Video studio" /><p align="center"><b>Video studio</b> — Wan 2.1 text-to-video with a live queue</p></td> <td><img src="docs/screenshots/en/clips.png" alt="Clips" /><p align="center"><b>Clips</b> — gallery with hover previews & player</p></td> </tr> </table>

🚀 Quick start

1. Download AceDeck-Setup-x.y.z.exe (installer) or AceDeck-Portable-x.y.z.exe from Releases.
2. Run it. Windows SmartScreen may warn because the build is not code-signed → More info → Run anyway.
3. On first launch AceDeck looks for an existing ACE-Step 1.5 checkout. If none is found, open Install, pick a folder and press Install ACE-Step — it downloads ~3 GB of Python packages and ~10 GB of models (≈ 5–15 min depending on your connection).
4. Press Start in the sidebar, go to Create, describe a song and hit Create. Songs land in Music\AceDeck.
5. Video: open Video engine → Install video engine (ComfyUI + PyTorch + ~10 GB of Wan 2.1 models, ≈ 5–10 min), then describe a scene in Video studio. Clips land in Videos\AceDeck.
6. New versions arrive inside the app: a badge appears in the sidebar and Settings → Updates downloads and installs them (1.0.0/1.0.1 have no updater — install 1.0.2 once by hand).

Already have ACE-Step 1.5? AceDeck auto-detects common locations (e.g. %USERPROFILE%\ACE-Step-1.5) or you can point it to any folder in Install → Use an existing installation.

💻 System requirements

| | Minimum | Recommended | |---|---|---| | OS | Windows 10 / 11 x64 | Windows 11 | | GPU | NVIDIA, 6 GB VRAM (LM disabled) | NVIDIA RTX, 12–16 GB+ VRAM | | Driver | CUDA 12.8 capable (RTX 50xx needs 570+) | latest Game Ready / Studio | | RAM | 16 GB | 32 GB+ | | Disk | ~25 GB free | SSD | | Network | first install only (~13 GB) | |

Measured on an RTX 5060 Ti 16 GB: engine start + model load ≈ 30 s; a 30-second song with LM planning ≈ 40 s end-to-end; a 15-second instrumental ≈ 10–16 s. Full stress test: Stable, 100/100.

Video studio (optional): +~16 GB of disk, 8 GB VRAM minimum (12 GB+ recommended). On the same RTX 5060 Ti a 2-second 832×480 clip renders in ≈ 1.5 min including ComfyUI start, a 5-second one at 30 steps in ≈ 8 min; peak VRAM ≈ 12 GB.

🤖 Control it with Claude (MCP)

AceDeck ships an MCP server, so Claude can operate your local music studio in plain language — “make 10 chill lo-fi instrumentals for my stream, 2 minutes each, and tell me where the files are”. The MCP server talks to AceDeck (not directly to ACE-Step), so jobs show up in the queue, songs land in the library, and if AceDeck is closed the server launches it automatically.

Claude Desktop — open Claude & MCP in AceDeck and click Add to Claude Desktop, then restart Claude Desktop.

Claude Code — copy the command from the same page, it looks like:

claude mcp add acedeck --scope user -e ELECTRON_RUN_AS_NODE=1 -- "C:\Users\<you>\AppData\Local\Programs\AceDeck\AceDeck.exe" "C:\Users\<you>\AppData\Local\Programs\AceDeck\resources\mcp\server.cjs"

No separate Node.js is needed — the AceDeck executable doubles as the Node runtime (ELECTRON_RUN_AS_NODE=1).

<details> <summary><b>Manual config (any MCP client)</b></summary>

{
  "mcpServers": {
    "acedeck": {
      "command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\AceDeck\\AceDeck.exe",
      "args": ["C:\\Users\\<you>\\AppData\\Local\\Programs\\AceDeck\\resources\\mcp\\server.cjs"],
      "env": { "ELECTRON_RUN_AS_NODE": "1" }
    }
  }
}

</details>

| Tool | What it does | |---|---| | acedeck_status | Engine state, GPU/VRAM, queue summary, library size | | engine_control | start / stop / restart the ACE-Step engine | | generate_music | Text-to-music from a description or caption + lyrics; count songs; waits and returns file paths | | transform_audio | cover (remix in a new style) or repaint (regenerate a section) of a local audio file | | draft_song | LM writes caption, lyrics, BPM, key and duration — no rendering | | list_queue, get_job, job_control, queue_control | Inspect / cancel / retry jobs, pause / resume / clear the queue | | list_tracks | Br