This repository is the Pinokio launcher for ACE-Step Studio — the actual app lives there. This repo only contains the scripts that Pinokio runs to install, start, update and reset the app in an isolated cross-platform environment.
- Download and install Pinokio
- Open in Pinokio:
- 🚀 Install (1-click) — direct install URL
- 📂 Browse app page — catalog page on beta.pinokio.co
- Click Install inside Pinokio — it will clone the app, create a Python 3.12 venv, install PyTorch (right build for your GPU), pull models on first run
- Isolated Python
venvwith Python 3.12 via uv — no system-wide installs - PyTorch auto-selected by GPU/OS — CUDA 12.8 (NVIDIA x64), CUDA 13.0 (aarch64), DirectML (AMD Win), ROCm 6.3 (AMD Linux), MPS/CPU (macOS), CPU fallback
- Triton + Flash-Attention 2 on NVIDIA Win/Linux (auto-skipped elsewhere)
- MLX native acceleration on Apple Silicon
- Bundled Node.js + npm + ffmpeg from Pinokio (no separate downloads)
- Frontend built via Vite, Express server via
tsx - Models cached under
app/models(HF_HOME) - Cross-platform: Windows / Linux x64 & aarch64 / macOS ARM & Intel
| Menu item | What it runs |
|---|---|
| Start (Standard) | Full Express + DiT + LM (PT backend) |
| Start (No LM) | DiT only — more VRAM free, no AI lyrics |
| Start (Dev) | tsx watch + Vite HMR (for launcher development) |
| Open Folder | File explorer at Generated Audio / App Data / Models cache |
| Update | git pull launcher + app + ACE-Step-1.5 + rebuild frontend |
| Save Disk Space | Dedup venv libraries via fs.link |
| Reset | Wipe app/ folder (full pre-install state) |
| OS | GPU | Status | Acceleration |
|---|---|---|---|
| Windows 10/11 | NVIDIA RTX 20xx–50xx | ✅ tested | CUDA 12.8 + Triton + Flash-Attn |
| Linux x64 | NVIDIA RTX 20xx–50xx | ✅ expected | CUDA 12.8 + Triton + Flash-Attn |
| Linux aarch64 | NVIDIA DGX Spark / Jetson | ✅ expected | CUDA 13.0 |
| Windows | AMD RDNA3+ | ✅ expected | DirectML |
| Linux | AMD RDNA3+ | ✅ expected | ROCm 6.3 |
| macOS | Apple Silicon M1–M4 | ✅ expected | MPS + MLX native |
| macOS | Intel | CPU | |
| Any | CPU only | CPU | |
| Win/Linux | NVIDIA GTX 10xx (Pascal) | ❌ cu128 requires sm_70+ |
— |
- 🎵 App source / issues — ACE-Step-Studio
- 📰 Changelog — CHANGELOG.md
- 🧠 Base model — ACE-Step 1.5
- 🎛️ Upstream UI — fspecii/ace-step-ui
- 🚀 Pinokio — pinokio.co
I build software and do research in AI and music/voice generation. Most of what I create is free and open source. Your donations allow me to keep creating and exploring without worrying about where the next meal comes from =)
All donation methods | dalink.to/nerual_dreming | boosty.to/neuro_art
- BTC:
1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC - ETH (ERC20):
0xb5db65adf478983186d4897ba92fe2c25c594a0c - USDT (TRC20):
TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C
- Nerual Dreming — @timoncool · Telegram · neuro-cartel.com · ArtGeneration.me
MIT — same as the main ACE-Step Studio project.