mlx-audio

library0.4.4pypypi✓ verified 80d ago

MLX-Audio enables inference of text-to-speech (TTS) and speech-to-speech (STS) models locally on Apple Silicon Macs using MLX. Current version 0.4.3, with active development and frequent releases.

ai-ml llm-agents

pip install mlx-audio

github ↗package ↗

INSTALL

IMPORT

SIG · MLX-AUDIO

mlx-audio

ai-mlpythonv0.4.4

Install

19.6s avg

Import

—

Disk

386MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.4.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 19.6s · import 0.000s · 398MB

386MB installed

● package 386MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Audio

✓ import mlx_audio

✗ from mlx_audio import Audio

Basic usage of the Audio class to load and play audio.

from mlx_audio import Audio # Load and play an audio file audio = Audio("path/to/audio.wav") print(audio.shape) audio.play()

Debug

Known issues

breakingIn v0.3.0, soundfile was replaced with miniaudio + ffmpeg. Audio format handling changed; ensure ffmpeg is installed.

fix

Install ffmpeg (e.g., brew install ffmpeg) and update any soundfile-dependent code.

affects: >=0.3.0

gotchaTTS and STS classes are not directly importable from mlx_audio; they are in submodules.

fix

Use from mlx_audio.tts import TTS or from mlx_audio.sts import STS.

affects: all

deprecatedThe old load() API was refactored in v0.3.0rc1; using it without the new pattern may fail.

fix

Check the docs for the updated load() signature; use Audio() directly.

affects: >=0.3.0

breakingIn v0.4.2, setuptools was pinned to <81 to avoid webrtcvad import error. If you have setuptools>=81, install may break.

fix

pip install 'setuptools<81' or use pinned dependencies from requirements.

affects: >=0.4.2

Upgrade

Version history

0.4.4latest on PyPI · released Jun 6, 2026

Audit

Dependencies

mlxrequiredRequired for all MLX operations

ffmpegrequiredUsed for audio format handling (replaced soundfile in v0.3.0)

setuptools<81optionalPinned to avoid webrtcvad import failure (see v0.4.2 fix)

Agent activity

19 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Blaizzy/mlx-audio ↗

packagehttps://pypi.org/project/mlx-audio/ ↗