AgentSkillsCN

acestep-docs

ACE-Step 使用文档与故障排查指南。当用户咨询 ACE-Step 的安装方法、GPU 配置、模型下载、Gradio 界面的使用、API 集成,或遇到诸如显存不足、CUDA 错误、模型加载失败等疑难问题时,请参考本指南。

SKILL.md
--- frontmatter
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

DocumentDescription
README.mdInstallation, model download, startup commands
Tutorial.mdGetting started tutorial, best practices
ABOUT.mdProject overview, architecture, model zoo

Guides

DocumentDescription
GRADIO_GUIDE.mdWeb UI usage guide
INFERENCE.mdInference parameters tuning
GPU_COMPATIBILITY.mdGPU/VRAM configuration, hardware recommendations
ENVIRONMENT_SETUP.mdEnvironment detection, uv installation, python_embeded setup
BAT_CONFIGURATION.mdConfiguring startup scripts (language, port, download source, etc.)
UPDATE_AND_BACKUP.mdFor portable package users: Git updates, file backup, conflict resolution

API (for developers)

DocumentDescription
API.mdREST API documentation
Openrouter_API.mdOpenRouter API integration

Instructions

  1. Installation questions → read getting-started/README.md
  2. General usage / best practices → read getting-started/Tutorial.md
  3. Project overview / architecture → read getting-started/ABOUT.md
  4. Web UI questions → read guides/GRADIO_GUIDE.md
  5. Inference parameter tuning → read guides/INFERENCE.md
  6. GPU/VRAM issues → read guides/GPU_COMPATIBILITY.md
  7. Environment setup (uv, python_embeded) → read guides/ENVIRONMENT_SETUP.md
  8. BAT file configuration → read guides/BAT_CONFIGURATION.md
  9. Portable package updates and backup → read guides/UPDATE_AND_BACKUP.md
  10. 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/BAT_CONFIGURATION.md
  • uv not found: See guides/ENVIRONMENT_SETUP.md
  • Environment detection issues: See guides/ENVIRONMENT_SETUP.md
  • BAT file configuration: See guides/BAT_CONFIGURATION.md
  • Portable package update issues: See guides/UPDATE_AND_BACKUP.md
  • Update conflicts (portable package): See guides/UPDATE_AND_BACKUP.md
  • Inference quality issues: See guides/INFERENCE.md
  • Gradio UI not starting: See guides/GRADIO_GUIDE.md