voxmlx
Realtime speech-to-text with Voxtral Mini Realtime in MLX.
Install
pip install voxmlx
Usage
voxmlx
Transcribe audio from a file or stream from the microphone in real-time.
Stream from microphone:
voxmlx
Transcribe a file:
voxmlx --audio audio.flac
Options:
| Flag | Description | Default |
|---|---|---|
--audio |
Path to audio file (omit to stream from mic) | None |
--model |
Model path or HuggingFace model ID | mlx-community/Voxtral-Mini-4B-Realtime-6bit |
--temp |
Sampling temperature (0 = greedy) |
0.0 |
voxmlx-convert
Convert Voxtral weights to voxmlx/MLX format with optional quantization.
Basic conversion:
voxmlx-convert --mlx-path voxtral-mlx
4-bit quantized conversion:
voxmlx-convert -q --mlx-path voxtral-mlx-4bit
Convert and upload to HuggingFace:
voxmlx-convert -q --mlx-path voxtral-mlx-4bit --upload-repo username/voxtral-mlx-4bit
Options:
| Flag | Description | Default |
|---|---|---|
--hf-path |
HuggingFace model ID or local path | mistralai/Voxtral-Mini-4B-Realtime-2602 |
--mlx-path |
Output directory | mlx_model |
-q, --quantize |
Quantize the model | Off |
--group-size |
Quantization group size | 64 |
--bits |
Bits per weight | 4 |
--dtype |
Cast weights (float16, bfloat16, float32) |
None |
--upload-repo |
HuggingFace repo to upload converted model | None |
Python API
from voxmlx import transcribe
text = transcribe("audio.flac")
print(text)
1 maintainer
Metadata
1 maintainer
Release files for voxmlx 0.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| voxmlx-0.0.2.tar.gz | 19.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| voxmlx-0.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.2 kB
Release files / voxmlx-0.0.2.tar.gz
| Download URL | voxmlx-0.0.2.tar.gz |
|---|---|
| Size | 19.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0798f2a0645ad73a106be8a96769c9ca8a7f9a03dbeb8e40b021307ecde5ffaa
|
|
BLAKE2b-256 checksum How to use checksums |
fa2bd5641f435ed350b6d0529f3cc8eed98c725a454f89b3e8993fd793d4165a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Release files / voxmlx-0.0.2-py3-none-any.whl
| Download URL | voxmlx-0.0.2-py3-none-any.whl |
|---|---|
| Size | 21.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
daedb7fa24d99948b78de94d95b053351b0c7d1e858ea04f0f88623436a957b8
|
|
BLAKE2b-256 checksum How to use checksums |
fad1b128c41a3ffe39eef8d9539f484c9f310cb74b37c6fbf1290374a816a739
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Security for voxmlx 0.0.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
