Note: This is the full-precision (bfloat16) variant. It offers the highest quality but runs below real-time on most hardware. Consider the 8-bit or 4-bit variants for faster inference.

Benchmarks (M4 Max, 36GB)

Variant	Size	Tokens/s	Real-time factor
bf16	6.2 GB	~51 tok/s	0.50x
8-bit	3.3 GB	~91 tok/s	0.82x
4-bit	1.8 GB	~108 tok/s	1.58x

Quick Start

Requires macOS with Apple Silicon and uv.

bash

# From a text file
uv run tts.py input.txt -o output.wav

# From stdin
echo "Hello world" | uv run tts.py - -o hello.wav

# With a custom voice description
uv run tts.py input.txt -o output.wav -d "Deep male voice, British accent, slow pacing."

CLI Options

Option	Default	Description
`input`	(required)	Input text file path, or `-` for stdin
`-o`, `--output`	`output.wav`	Output WAV file path
`-d`, `--description`	Calm/clear female voice	Voice description prompt
`-m`, `--model`	`.`	Path to MLX model directory
`--max-chars`	`200`	Max characters per chunk
`--max-tokens`	`2048`	Max tokens per chunk
`--temperature`	`0.4`	Sampling temperature
`--top-p`	`0.9`	Top-p sampling
`--repetition-penalty`	`1.1`	Repetition penalty

Requirements

macOS with Apple Silicon (M1 or later)
uv (dependencies are declared inline via PEP 723)

0xhb/maya1-mlx-bf16

maya1-mlx-bf16

Benchmarks (M4 Max, 36GB)

Quick Start

CLI Options

Requirements

0xhb/
maya1-mlx-bf16