The open-source AI voice studio. Clone, dictate, create.
fix(backend): count the S3TokenizerV2 repo in the Chatterbox MLX cache check; register the backend with PyInstaller
jamiepinead6ec3c6ef3d
diff --git a/backend/backends/__init__.py b/backend/backends/__init__.pyindex fd8759cf..5d006d59 100644--- a/backend/backends/__init__.py+++ b/backend/backends/__init__.py@@ -297,7 +297,8 @@ def _get_non_qwen_tts_configs() -> list[ModelConfig]:on_mlx = get_backend_type() == "mlx"if on_mlx:chatterbox_repo = "mlx-community/chatterbox-multilingual-v3"- chatterbox_size_mb = 2600+ # 2.5 GB of weights plus the separately fetched S3TokenizerV2 (~470 MB)+ chatterbox_size_mb = 3000else:chatterbox_repo = "ResembleAI/chatterbox"chatterbox_size_mb = 3200diff --git a/backend/backends/chatterbox_mlx_backend.py b/backend/backends/chatterbox_mlx_backend.pyindex d4629426..ca26c75a 100644--- a/backend/backends/chatterbox_mlx_backend.py+++ b/backend/backends/chatterbox_mlx_backend.py@@ -30,9 +30,13 @@ from .mlx_backend import _run_on_mlx_threadlogger = logging.getLogger(__name__)CHATTERBOX_MLX_HF_REPO = "mlx-community/chatterbox-multilingual-v3"+# mlx-audio's Model.from_pretrained fetches the S3 speech tokenizer from this+# second repo (~470 MB), so the engine is only "downloaded" once both are cached.+S3_TOKENIZER_HF_REPO = "mlx-community/S3TokenizerV2"# Files that must be present for the MLX multilingual model_MLX_WEIGHT_FILES = ["model.safetensors", "config.json", "tokenizer.json"]+_S3_TOKENIZER_FILES = ["model.safetensors", "config.json"]class ChatterboxMLXTTSBackend:@@ -51,7 +55,9 @@ class ChatterboxMLXTTSBackend:return CHATTERBOX_MLX_HF_REPOdef _is_model_cached(self, model_size: str = "default") -> bool:- return is_model_cached(CHATTERBOX_MLX_HF_REPO, required_files=_MLX_WEIGHT_FILES)+ model_cached = is_model_cached(CHATTERBOX_MLX_HF_REPO, required_files=_MLX_WEIGHT_FILES)+ tokenizer_cached = is_model_cached(S3_TOKENIZER_HF_REPO, required_files=_S3_TOKENIZER_FILES)+ return model_cached and tokenizer_cachedasync def load_model(self, model_size: str = "default") -> None:"""Load the Chatterbox multilingual MLX model."""@@ -75,7 +81,7 @@ class ChatterboxMLXTTSBackend:logger.info("Loading Chatterbox Multilingual TTS on MLX (Metal)...")ckpt_dir = snapshot_download(CHATTERBOX_MLX_HF_REPO)- self.model = Model.from_pretrained(ckpt_dir)+ self.model = Model.from_pretrained(ckpt_dir, s3_tokenizer_repo=S3_TOKENIZER_HF_REPO)logger.info("Chatterbox Multilingual TTS (MLX) loaded successfully")diff --git a/backend/build_binary.py b/backend/build_binary.pyindex 691c775e..0a7cf879 100644--- a/backend/build_binary.py+++ b/backend/build_binary.py@@ -442,6 +442,8 @@ def build_server(cuda=False, rocm=False):"mlx_lm","--hidden-import","backend.backends.qwen_llm_backend",+ "--hidden-import",+ "backend.backends.chatterbox_mlx_backend","--collect-submodules","mlx","--collect-submodules",diff --git a/backend/voicebox-server.spec b/backend/voicebox-server.specindex d0e8d978..a40d99cb 100644--- a/backend/voicebox-server.spec+++ b/backend/voicebox-server.spec@@ -5,7 +5,7 @@ from PyInstaller.utils.hooks import copy_metadatadatas = []binaries = []-hiddenimports = ['backend', 'backend.main', 'backend.config', 'backend.database', 'backend.models', 'backend.services.profiles', 'backend.services.history', 'backend.services.tts', 'backend.services.transcribe', 'backend.utils.platform_detect', 'backend.backends', 'backend.backends.pytorch_backend', 'backend.backends.qwen_custom_voice_backend', 'backend.utils.audio', 'backend.utils.cache', 'backend.utils.progress', 'backend.utils.hf_progress', 'backend.services.cuda', 'backend.services.effects', 'backend.utils.effects', 'backend.services.versions', 'pedalboard', 'chatterbox', 'chatterbox.tts_turbo', 'chatterbox.mtl_tts', 'backend.backends.chatterbox_backend', 'backend.backends.chatterbox_turbo_backend', 'backend.backends.luxtts_backend', 'zipvoice', 'zipvoice.luxvoice', 'torch', 'transformers', 'fastapi', 'uvicorn', 'sqlalchemy', 'soundfile', 'qwen_tts', 'qwen_tts.inference', 'qwen_tts.inference.qwen3_tts_model', 'qwen_tts.inference.qwen3_tts_tokenizer', 'qwen_tts.core', 'qwen_tts.cli', 'requests', 'pkg_resources.extern', 'backend.backends.hume_backend', 'tada', 'tada.modules', 'tada.modules.tada', 'tada.modules.encoder', 'tada.modules.decoder', 'tada.modules.aligner', 'tada.modules.acoustic_spkr_verf', 'tada.nn', 'tada.nn.vibevoice', 'tada.utils', 'tada.utils.gray_code', 'tada.utils.text', 'backend.utils.dac_shim', 'torchaudio', 'backend.backends.kokoro_backend', 'en_core_web_sm', 'loguru', 'backend.mcp_server', 'backend.mcp_server.server', 'backend.mcp_server.tools', 'backend.mcp_server.context', 'backend.mcp_server.resolve', 'backend.mcp_server.events', 'sse_starlette', 'backend.backends.mlx_backend', 'mlx', 'mlx.core', 'mlx.nn', 'mlx_audio', 'mlx_audio.tts', 'mlx_audio.stt', 'mlx_lm', 'backend.backends.qwen_llm_backend']+hiddenimports = ['backend', 'backend.main', 'backend.config', 'backend.database', 'backend.models', 'backend.services.profiles', 'backend.services.history', 'backend.services.tts', 'backend.services.transcribe', 'backend.utils.platform_detect', 'backend.backends', 'backend.backends.pytorch_backend', 'backend.backends.qwen_custom_voice_backend', 'backend.utils.audio', 'backend.utils.cache', 'backend.utils.progress', 'backend.utils.hf_progress', 'backend.services.cuda', 'backend.services.effects', 'backend.utils.effects', 'backend.services.versions', 'pedalboard', 'chatterbox', 'chatterbox.tts_turbo', 'chatterbox.mtl_tts', 'backend.backends.chatterbox_backend', 'backend.backends.chatterbox_turbo_backend', 'backend.backends.luxtts_backend', 'zipvoice', 'zipvoice.luxvoice', 'torch', 'transformers', 'fastapi', 'uvicorn', 'sqlalchemy', 'soundfile', 'qwen_tts', 'qwen_tts.inference', 'qwen_tts.inference.qwen3_tts_model', 'qwen_tts.inference.qwen3_tts_tokenizer', 'qwen_tts.core', 'qwen_tts.cli', 'requests', 'pkg_resources.extern', 'backend.backends.hume_backend', 'tada', 'tada.modules', 'tada.modules.tada', 'tada.modules.encoder', 'tada.modules.decoder', 'tada.modules.aligner', 'tada.modules.acoustic_spkr_verf', 'tada.nn', 'tada.nn.vibevoice', 'tada.utils', 'tada.utils.gray_code', 'tada.utils.text', 'backend.utils.dac_shim', 'torchaudio', 'backend.backends.kokoro_backend', 'en_core_web_sm', 'loguru', 'backend.mcp_server', 'backend.mcp_server.server', 'backend.mcp_server.tools', 'backend.mcp_server.context', 'backend.mcp_server.resolve', 'backend.mcp_server.events', 'sse_starlette', 'backend.backends.mlx_backend', 'mlx', 'mlx.core', 'mlx.nn', 'mlx_audio', 'mlx_audio.tts', 'mlx_audio.stt', 'mlx_lm', 'backend.backends.qwen_llm_backend', 'backend.backends.chatterbox_mlx_backend']datas += copy_metadata('qwen-tts')datas += copy_metadata('requests')datas += copy_metadata('transformers')