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 ${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 ${baseDir}/mlx-tts.sh "\x3Ctext>"

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:

{
   "action": "send",
   "filePath": "\x3Cfilepath>"
}

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", ...)