mlx-audio

环境要求

• Apple Silicon 芯片的 Mac（M 系列芯片），MLX 针对苹果芯片优化
• Python 环境（使用 pip 安装）
• 可选：uv 工具（仅安装命令行工具时使用）
• 可选：ffmpeg（保存 MP3/FLAC/OGG/Opus/Vorbis 格式时需要）

安装与启动步骤

1. 1确认硬件环境

   mlx-audio 基于 Apple 的 MLX 框架，只能在 Apple Silicon（M 系列芯片）设备上运行，请先确认你的 Mac 属于该范围。

2. 2用 pip 安装

   标准安装方式，会把 mlx-audio 作为 Python 库装入当前环境，适合在 Python 项目中调用。

   pip install mlx-audio

   复制

3. 3用 uv 装命令行

   uv tool 方式只安装命令行工具，且不加 --prerelease=allow 会装不到预发布版本。

   uv tool install --force mlx-audio --prerelease=allow

   复制

4. 4uv 装 GitHub 最新代码

   想体验仓库最新功能而非 PyPI 发布版时，用 git+ 地址直接从 GitHub 安装。

   uv tool install --force git+https://github.com/Blaizzy/mlx-audio.git --prerelease=allow

   复制

5. 5安装 ffmpeg

   README 明确说明保存 MP3、FLAC、OGG、Opus、Vorbis 格式必须依赖 ffmpeg，仅存 WAV 可跳过；具体命令原文未给出，请按各自系统方式安装。

如何确认成功

执行 pip show mlx-audio 能看到包名与版本号，或 uv tool list 中列出 mlx-audio，即表示安装成功。

常见问题

注意事项

• 项目面向 Apple Silicon 设备，Intel Mac 与其他平台不在支持范围内。
• 建议在 Python 虚拟环境或虚拟工具环境中安装，避免污染系统环境。
• 安装完成后可参考 README 的 Quick Start、Supported Models 与 Model Examples 章节了解文本转语音、语音转文本等用法。
• 项目提供交互式 Web 界面与 OpenAI 兼容的 REST API 服务，还支持 3/4/6/8-bit 量化以降低内存占用，具体用法见 README 对应章节。