# Mlx Tts

> Text-To-Speech with MLX (Apple Silicon) and opensource models (default QWen3-TTS) locally.

- Skill: `guoqiao/mlx-tts` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add guoqiao/mlx-tts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/guoqiao/mlx-tts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: guoqiao (https://skillmd.com/u/guoqiao)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/guoqiao/mlx-tts

---


# MLX TTS

Text-To-Speech with MLX (Apple Silicon) and open-source models (default QWen3-TTS) locally.

Free and Fast. No API key required. No server required.

## Requirements

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

## Installation

```bash
bash ${baseDir}/install.sh
```
This script will use `brew` to install these CLI tools if not available:
- `uv`: install python package and run python script
- `mlx_audio`: do the real job

## Usage

To generate audio from text, run this script:

```bash
bash ${baseDir}/mlx-tts.sh "<text>"
```

### Agent Instructions

1. **Run the script**: Pass the text to be spoken as an argument.
2. **Handle Output**: The script will output a path to a audio file.
Use the `message` tool to send the audio file to the user as an voice message:
```json
{
   "action": "send",
   "filePath": "<filepath>"
}
```

Example:

User: "Say hello world"

Agent:
1. Runs `bash path/to/mlx-tts.sh "hello world"`
2. Receives output: `/tmp/folder/audio.ogg`
3. Calls `message(action="send", filePath="/tmp/folder/audio.ogg", ...)`