guoqiao

MLX Audio Server

Developmentv0.2.2
By guoqiaoUpdated 2026-05-178 versions · latest released 2026-02-10mlx-audio-server@clawhub_guoqiao/mlx-audio-server
Backend#Audio

According to AlphaMoat, as of 2026-09, MLX Audio Server has 3,849 downloads and 0 stars — ranked #2,719 of 5,078 AI skills overall, and #353 of 577 in Development.

Installs
125
Downloads
3.8K
Stars
-
Overall Rank
#2,719
Top 54% overall · Top 62% in Development
PlatformInstallsDownloadsStarsComments
ClawHub ↗1253.8K-1
SkillHub ↗1253.8K-—

Platforms count differently and update at different times.

What this skill does

It provides scripts for speech-to-text and text-to-speech; transcription returns text, while generated audio is saved to a local path. The installation uses a third-party Homebrew tap and starts a persistent background service, so review dependencies, keep use within trusted local workflows, and avoid submitting sensitive audio or text.

Profile published 2026-10-29

What you can do with it

  • Run local speech transcription on an Apple Silicon Mac
  • Generate speech audio through a helper script
  • Plan how a local audio API service will be operated

When to use it

  • When the environment meets the macOS and Apple Silicon requirements and dependencies and service exposure can be reviewed

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Outline how to use the existing script to transcribe local audio without installing dependencies or starting the service.
List the Homebrew source, service exposure, and sensitive-data checks for a local audio API deployment.

Monthly Trend

Downloads3.8K
3.1K3.5K3.9K2026-05 · Downloads 3.2K2026-06 · Downloads 3.3K2026-07 · Downloads 3.6K2026-08 · Downloads 3.7K2026-09 · Downloads 3.8K26-0526-09
Stars-
0112026-05 · Stars -2026-06 · Stars -2026-07 · Stars -2026-08 · Stars -2026-09 · Stars -26-0526-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-093.8K—-
2026-083.7K+3.6%-
2026-073.6K+7.4%-
2026-063.3K+4.8%-
2026-053.2K—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

1.8 KB · ClawHub v0.2.2
---
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.
Show all (48 lines)
[mlx-audio](https://github.com/Blaizzy/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](https://github.com/guoqiao/homebrew-tap/blob/main/Formula/mlx-audio-server.rb): 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
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**):
```bash
# 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**):
```bash
# 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.

Popular in Development

More from guoqiao

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.