ace-step-music

ACE-Step 1.5 Skill for OpenClaw

概述

本 Skill 提供在 Apple Silicon Mac (M1/M2/M3/M4) 上自动化部署和调用 ACE-Step 1.5 音乐生成模型的能力。

环境要求

最低配置

• 芯片: Apple Silicon (M1/M2/M3/M4)
• 内存: 16GB (32GB 推荐)
• 存储: 10GB 可用空间
• 系统: macOS 13.0+

推荐配置 (主人设备)

• 芯片: M2
• 内存: 32GB ✅ 超额满足
• 存储: 485GB 可用 ✅
• 后端: MLX (Apple Silicon 原生优化)

安装步骤

1. 环境准备

# 检查 Python 版本 (需要 3.10+)
python3 --version

# 创建虚拟环境 (推荐)
python3 -m venv ~/ace-step-env
source ~/ace-step-env/bin/activate

# 升级 pip
pip install --upgrade pip

2. 安装 ACE-Step

# 克隆仓库
git clone https://github.com/ace-step/ACE-Step-1.5.git ~/workspace/ace-step
cd ~/workspace/ace-step

# macOS 使用 MLX 后端安装
pip install -e ".[mlx]"

# 或使用官方脚本
./scripts/install_macos.sh

3. 下载模型权重

# 自动下载 (首次运行时会自动下载)
# 或手动从 HuggingFace 下载
huggingface-cli download ace-step/ACE-Step-1.5 --local-dir ./models

4. 验证安装

# 运行测试生成
python -m ace_step.generate --prompt "A peaceful piano melody" --output test.wav

使用方法

基础生成

from ace_step import MusicGenerator

# 初始化生成器 (MLX 后端自动识别)
generator = MusicGenerator(
    model_path="./models",
    device="mps",  # Metal Performance Shaders
    precision="float16"
)

# 生成音乐
music = generator.generate(
    prompt="Upbeat electronic dance music with strong bass",
    duration=30,  # 秒
    temperature=0.8
)

# 保存
music.save("output.wav")

高级配置

config = {
    "backend": "mlx",           # Apple Silicon 最优
    "device": "mps",            # Metal Performance Shaders
    "precision": "float16",     # 平衡速度和质量
    "max_memory": "24GB",       # 保留 8GB 给系统
    "quantize": "int8",         # 可选：进一步加速
    "sampling_rate": 44100,
    "channels": 2
}

generator = MusicGenerator(**config)

Agent 调用接口

工具函数

async def generate_music(
    prompt: str,
    duration: int = 30,
    style: str = "auto",
    output_path: str = "./output.wav"
) -> dict:
    """
    生成音乐文件
    
    Args:
        prompt: 音乐描述文本
        duration: 时长(秒)，默认30
        style: 风格提示，可选
        output_path: 输出路径
    
    Returns:
        {
            "success": bool,
            "file_path": str,
            "duration": float,
            "generation_time": float
        }
    """
    pass

async def check_installation() -> dict:
    """检查 ACE-Step 安装状态"""
    pass

async def get_system_info() -> dict:
    """获取当前系统性能和配置信息"""
    pass