Skip to content

The open-source AI voice studio. Clone, dictate, create.

fix(backend): pin miniaudio in requirements-mlx.txt (#505) (#506)

Jamie Pine21dd3b8315da
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 25e5a943..edf29609 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -106,8 +106,10 @@ jobs:
# fine on transformers 4.57.x in practice (verified in dev), so install
# them --no-deps. mlx-audio's other runtime deps (huggingface_hub,
# librosa, numpy, numba, pyloudnorm) are already in requirements.txt;
- # the rest (sounddevice, miniaudio, protobuf, sentencepiece, pyyaml,
- # jinja2) are pulled in by other engines.
+ # miniaudio is in requirements-mlx.txt (needed by mlx_audio.stt,
+ # not transitively pulled by anything else — see issue #505); the
+ # rest (sounddevice, protobuf, sentencepiece, pyyaml, jinja2) are
+ # pulled in by other engines.
pip install --no-deps mlx-lm==0.31.1
pip install --no-deps mlx-audio==0.4.1
diff --git a/backend/requirements-mlx.txt b/backend/requirements-mlx.txt
index fb99faeb..b1a82d5d 100644
--- a/backend/requirements-mlx.txt
+++ b/backend/requirements-mlx.txt
@@ -3,6 +3,12 @@
mlx>=0.30.0
+# miniaudio is a runtime dep of mlx-audio's STT path (mlx_audio.stt).
+# mlx-audio itself is installed --no-deps (see comment below), so we
+# must list miniaudio explicitly here or transcription fails on fresh
+# M1 installs with `ModuleNotFoundError: miniaudio` (issue #505).
+miniaudio>=1.59
+
# NOTE: mlx-audio is intentionally not listed here. From 0.3.1 onward it
# declares `transformers==5.0.0rc3` / `>=5.0.0`, which conflicts with the
# `transformers<=4.57.6` cap in requirements.txt and breaks CI's clean
@@ -10,6 +16,7 @@ mlx>=0.30.0
# mlx_audio.stt.load) works fine on transformers 4.57.x in practice.
#
# Install it via `pip install --no-deps mlx-audio==0.4.1` after this file
-# (see .github/workflows/release.yml). All other mlx-audio runtime deps
-# (huggingface_hub, librosa, miniaudio, mlx-lm, numba, numpy, protobuf,
-# pyloudnorm, sounddevice, tqdm) are already in requirements.txt.
+# (see .github/workflows/release.yml). Most other mlx-audio runtime deps
+# (huggingface_hub, librosa, mlx-lm, numba, numpy, protobuf, pyloudnorm,
+# sounddevice, tqdm) are already in requirements.txt or pulled in by
+# other engines.