README.md

ACE-Step-1.5

Installation

This project uses uv for dependency management.

Install uv

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Install Project Dependencies

# Sync all dependencies
uv sync

Run the Project

# Simplest way - run directly with uv
uv run acestep

# Run with parameters
uv run acestep --port 7860 --server-name 0.0.0.0 --share

# Or use the full module path
uv run python -m acestep.acestep_v15_pipeline

# Just Run profiling
uv run profile_inference.py

# Or activate the virtual environment first
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate  # Windows

acestep

Available parameters:

• --port: Server port (default: 7860)
• --server-name: Server address (default: 127.0.0.1, use 0.0.0.0 to listen on all interfaces)
• --share: Create a public share link
• --debug: Enable debug mode

Development

Add new dependencies:

# Add runtime dependencies
uv add package-name

# Add development dependencies
uv add --dev package-name

Update dependencies:

uv sync --upgrade