360 Secure SkillHub
360 安全技能中心

MLX Audio Server

在 macOS Apple Silicon 上用 brew 安装 mlx-audio-server 并常驻运行 OpenAI 兼容的本地 STT/TTS 服务;run_stt.sh 把音频或视频转成转录文本,run_tts.sh 把文本合成为 wav 音频并打印文件路径。

guoqiao
guoqiao
热度 89.35
最近更新 2026-05-17 11:22:41
分类:效率依赖:代码执行 / 读写文件 / 第三方 API应用场景:文件转换 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add mlx-audio-server
Metadata
name
mlx-audio-server
description
Local 24x7 OpenAI-compatible API server for STT/TTS, powered by MLX on your Mac.
metadata
{"openclaw":{"always":true,"emoji":"🦞","homepage":"https://github.com/guoqiao/skills/blob/main/mlx-audio-server/mlx-audio-server/SKILL.md","os":["darwin"],"requires":{"bins":["brew"]}}}

MLX Audio Server

Local 24x7 OpenAI-compatible API server for STT/TTS, powered by MLX on your Mac.

mlx-audio: The best audio processing library built on Apple's MLX framework, providing fast and efficient text-to-speech (TTS), speech-to-text (STT), and speech-to-speech (STS) on Apple Silicon.

guoqiao/tap/mlx-audio-server: Homebrew Formula to install mlx-audio with brew, and run mlx_audio.server as a LaunchAgent service on macOS.

Requirements

  • mlx: macOS with Apple Silicon
  • brew: used to install deps if not available

Installation

bash ${baseDir}/install.sh

This script will:

  • install ffmpeg/jq with brew if missing.
  • install homebrew formula mlx-audio-server from guoqiao/tap
  • start brew service for mlx-audio-server

Usage

STT/Speech-To-Text(default model: mlx-community/glm-asr-nano-2512-8bit):

# input will be converted to wav with ffmpeg, if not yet.
# output will be transcript text only.
bash ${baseDir}/run_stt.sh <audio_or_video_path>

TTS/Text-To-Speech(default model: mlx-community/Qwen3-TTS-12Hz-1.7B-VoiceDesign-bf16):

# audio will be saved into a tmp dir, with default name `speech.wav`, and print to stdout.
bash ${baseDir}/run_tts.sh "Hello, Human!"
# or you can specify a output dir
bash ${baseDir}/run_tts.sh "Hello, Human!" ./output
# output will be audio path only.

You can use both scripts directly, or as example/reference.