# 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. Use when this capability is needed.

- Skill: `tomevault-io/acestep-docs-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/acestep-docs-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/acestep-docs-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/acestep-docs-2

---


# 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 |
| [BAT_CONFIGURATION.md](guides/BAT_CONFIGURATION.md) | Configuring startup scripts (language, port, download source, etc.) |
| [UPDATE_AND_BACKUP.md](guides/UPDATE_AND_BACKUP.md) | **For portable package users**: Git updates, file backup, conflict resolution |

### 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. BAT file configuration → read [guides/BAT_CONFIGURATION.md](guides/BAT_CONFIGURATION.md)
9. Portable package 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/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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/clockworksquirrel) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->