ACE-Step：装环境、跑推理、排故障
安装、显存要求、模型下载、Gradio 界面、API 接入、常见故障排查。
What it produces
ACE-Step 的安装、GPU 配置、模型下载、Gradio 界面与 API 接入文档
Install
d=$(mktemp -d);
git -C "$d" init -q;
git -C "$d" fetch -q --depth 1 --filter=blob:none https://github.com/ace-step/ACE-Step-1.5.git ca1e85fe9430179831e6bc6be790c332190a3866;
git -C "$d" sparse-checkout set --no-cone .claude/skills/acestep-docs;
git -C "$d" checkout -q FETCH_HEAD;
mkdir -p ~/.claude/skills/acestep-docs;
cp -R "$d/.claude/skills/acestep-docs/." ~/.claude/skills/acestep-docs/;
rm -rf "$d"Installs to ~/.claude/skills/acestep-docs; to switch to Codex or Hermes, change only this path.
--- name: acestep-docs description: ACE-Step documentation and troubleshooting. Use when users ask about installing ACE-Step, GPU configuration, model download, Gradio UI usage, API integration, or troubleshooting issues like VRAM problems, CUDA errors, or model loading failures. allowed-tools: Read, Glob, Grep --- # ACE-Step Documentation Documentation skill for ACE-Step music generation system. ## Quick Reference ### Getting Started | Document | Description | |----------|-------------| | [README.md](getting-started/README.md) | Installation, model download, startup commands | | [Tutorial.md](getting-started/Tutorial.md) | Getting started tutorial, best practices | | [ABOUT.md](getting-started/ABOUT.md) | Project overview, architecture, model zoo | ### Guides | Document | Description | |----------|-------------| | [GRADIO_GUIDE.md](guides/GRADIO_GUIDE.md) | Web UI usage guide | | [INFERENCE.md](guides/INFERENCE.md) | Inference parameters tuning | | [GPU_COMPATIBILITY.md](guides/GPU_COMPATIBILITY.md) | GPU/VRAM configuration, hardware recommendations | | [ENVIRONMENT_SETUP.md](guides/ENVIRONMENT_SETUP.md) | Environment detection, uv installation, python_embeded setup (Windows/Linux/macOS) | | [SCRIPT_CONFIGURATION.md](guides/SCRIPT_CONFIGURATION.md) | Configuring launch scripts: .bat (Windows) and .sh (Linux/macOS) | | [UPDATE_AND_BACKUP.md](guides/UPDATE_AND_BACKUP.md) | Git updates, file backup, conflict resolution (all platforms) | ### API (for developers) | Document | Description | |----------|-------------| | [API.md](api/API.md) | REST API documentation | | [Openrouter_API.md](api/Openrouter_API.md) | OpenRouter API integration | ## Instructions 1. Installation questions → read [getting-started/README.md](getting-started/README.md) 2. General usage / best practices → read [getting-started/Tutorial.md](getting-started/Tutorial.md) 3. Project overview / architecture → read [getting-started/ABOUT.md](getting-started/ABOUT.md) 4. Web UI questions → read [guides/GRADIO_GUIDE.md](guides/GRADIO_GUIDE.md) 5. Inference parameter tuning → read [guides/INFERENCE.md](guides/INFERENCE.md) 6. GPU/VRAM issues → read [guides/GPU_COMPATIBILITY.md](guides/GPU_COMPATIBILITY.md) 7. Environment setup (uv, python_embeded) → read [guides/ENVIRONMENT_SETUP.md](guides/ENVIRONMENT_SETUP.md) 8. Launch script configuration (.bat/.sh) → read [guides/SCRIPT_CONFIGURATION.md](guides/SCRIPT_CONFIGURATION.md) 9. Updates and backup → read [guides/UPDATE_AND_BACKUP.md](guides/UPDATE_AND_BACKUP.md) 10. API development → read [api/API.md](api/API.md) or [api/Openrouter_API.md](api/Openrouter_API.md) ## Common Issues - **Installation problems**: See getting-started/README.md - **VRAM insufficient**: See guides/GPU_COMPATIBILITY.md - **Model download failed**: See getting-started/README.md or guides/SCRIPT_CONFIGURATION.md - **uv not found**: See guides/ENVIRONMENT_SETUP.md - **Environment detection issues**: See guides/ENVIRONMENT_SETUP.md - **BAT/SH script configuration**: See guides/SCRIPT_CONFIGURATION.md - **Update and backup**: See guides/UPDATE_AND_BACKUP.md - **Update conflicts**: See guides/UPDATE_AND_BACKUP.md - **Inference quality issues**: See guides/INFERENCE.md - **Gradio UI not starting**: See guides/GRADIO_GUIDE.md