wyoming-mlx-whisper 1.0.0

Wyoming Server for MLX whisper

Wyoming MLX Whisper

Wyoming protocol server for mlx-whisper speech-to-text on Apple Silicon.

Uses mlx-community/whisper-large-v3-turbo by default, which runs near real-time on M1 Pro and newer.

[ToC] 📚

• Requirements
• Installation
  • Using uv (recommended)
  • Using pip
• Usage
  • Run directly
  • Run as macOS service (launchd)
• Options
• Development
• Acknowledgements

Requirements

• macOS with Apple Silicon (M1/M2/M3)
• Python 3.10-3.13
• uv (recommended) or pip

Installation

Using uv (recommended)

git clone https://github.com/basnijholt/wyoming-mlx-whisper.git
cd wyoming-mlx-whisper
uv sync

Using pip

git clone https://github.com/basnijholt/wyoming-mlx-whisper.git
cd wyoming-mlx-whisper
pip install .

Usage

Run directly

# With uv
uv run wyoming-mlx-whisper --uri tcp://0.0.0.0:7891

# Or if installed with pip
wyoming-mlx-whisper --uri tcp://0.0.0.0:7891

Run as macOS service (launchd)

Install the service (starts automatically on login):

./scripts/install_service.sh

The server runs at tcp://localhost:7891 by default.

Uninstall the service:

./scripts/uninstall_service.sh

View logs:

tail -f log/run.out log/run.err

Options

See the output of wyoming-mlx-whisper --help

 Usage: wyoming-mlx-whisper [OPTIONS]

 Run the Wyoming MLX Whisper server.

╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --uri                           TEXT  unix:// or tcp://                      │
│                                       [env var: WHISPER_URI]                 │
│                                       [default: tcp://0.0.0.0:10300]         │
│ --model                         TEXT  Name of MLX Whisper model to use       │
│                                       [env var: WHISPER_MODEL]               │
│                                       [default:                              │
│                                       mlx-community/whisper-large-v3-turbo]  │
│ --language                      TEXT  Language code (e.g., 'en')             │
│                                       [env var: WHISPER_LANGUAGE]            │
│ --debug           --no-debug          Log DEBUG messages                     │
│                                       [env var: WHISPER_DEBUG]               │
│                                       [default: no-debug]                    │
│ --log-format                    TEXT  Format for log messages                │
│                                       [default:                              │
│                                       %(levelname)s:%(name)s:%(message)s]    │
│ --version                             Print version and exit                 │
│ --help        -h                      Show this message and exit.            │
╰──────────────────────────────────────────────────────────────────────────────╯

Development

uv sync
uv run pre-commit install

Acknowledgements

• Forked from vincent861223/wyoming-mlx-whisper by Vincent Lin
• Based on wyoming-whisper-api-client by Dr. Serge Victor