acestep-docs
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.
SKILL.md
Full skill instructions
ACE-Step Documentation
Documentation skill for ACE-Step music generation system.
Quick Reference
Getting Started
| Document | Description |
|---|---|
| README.md | Installation, model download, startup commands |
| Tutorial.md | Getting started tutorial, best practices |
| ABOUT.md | Project overview, architecture, model zoo |
Guides
| Document | Description |
|---|---|
| GRADIO_GUIDE.md | Web UI usage guide |
| INFERENCE.md | Inference parameters tuning |
| GPU_COMPATIBILITY.md | GPU/VRAM configuration, hardware recommendations |
| ENVIRONMENT_SETUP.md | Environment detection, uv installation, python_embeded setup (Windows/Linux/macOS) |
| SCRIPT_CONFIGURATION.md | Configuring launch scripts: .bat (Windows) and .sh (Linux/macOS) |
| UPDATE_AND_BACKUP.md | Git updates, file backup, conflict resolution (all platforms) |
API (for developers)
| Document | Description |
|---|---|
| API.md | REST API documentation |
| Openrouter_API.md | OpenRouter API integration |
Instructions
- Installation questions → read getting-started/README.md
- General usage / best practices → read getting-started/Tutorial.md
- Project overview / architecture → read getting-started/ABOUT.md
- Web UI questions → read guides/GRADIO_GUIDE.md
- Inference parameter tuning → read guides/INFERENCE.md
- GPU/VRAM issues → read guides/GPU_COMPATIBILITY.md
- Environment setup (uv, python_embeded) → read guides/ENVIRONMENT_SETUP.md
- Launch script configuration (.bat/.sh) → read guides/SCRIPT_CONFIGURATION.md
- Updates and backup → read guides/UPDATE_AND_BACKUP.md
- API development → read api/API.md or 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