| --- |
| license: mit |
| pipeline_tag: text-to-speech |
| library_name: rlx |
| tags: |
| - chatterbox |
| - tts |
| - onnx |
| - rlx |
| --- |
| |
| # ChatterBox ONNX + RLX native (staging) |
|
|
| ChatterBox ONNX tree plus RLX `native/` T3 extract (parity bins removed). |
|
|
| | Field | Value | |
| |---|---| |
| | **Hub id** | [`eugenehp/chatterbox`](https://huggingface.co/eugenehp/chatterbox) | |
| | **Kind** | Converted / re-laid-out for RLX from an upstream checkpoint. | |
| | **RLX crate** | [`rlx-chatterbox`](https://github.com/MIT-RLX/rlx-models/tree/main/crates/rlx-chatterbox) | |
| | **Upstream** | https://huggingface.co/synath/chatterbox-ONNX | |
|
|
| ## Quick start |
|
|
| ```bash |
| hf download eugenehp/chatterbox --local-dir . |
| cargo run -p rlx-chatterbox --release -- --model-dir . |
| ``` |
|
|
| ## File highlights |
|
|
| - `native/t3_lm.safetensors` (976.2 MiB) |
| - `t3-q4_k_m.gguf` (299.6 MiB) |
| - `onnx/cfm_estimator.onnx` (273.0 MiB) |
| - `onnx/flow_encoder.onnx` (177.2 MiB) |
| - `onnx/hift_head.onnx` (79.6 MiB) |
| - `onnx/hift_stages.onnx` (79.6 MiB) |
| - `weights.safetensors` (77.6 MiB) |
| - `native/embed_tables.safetensors` (58.8 MiB) |
| - `native/rope_cache.safetensors` (32.0 MiB) |
| - `onnx/hift_src.onnx` (12.6 MiB) |
| - `onnx/hift_f0.onnx` (12.5 MiB) |
| - `onnx/conditional_decoder.onnx` (6.1 MiB) |
| - `onnx/speech_encoder.onnx` (1.1 MiB) |
| - `default_voice.wav` (697.6 KiB) |
| - `onnx/language_model_q4f16.onnx` (224.0 KiB) |
| - `onnx/language_model_fp16.onnx` (168.6 KiB) |
|
|
| ## Run with RLX |
|
|
| Clone [rlx-models](https://github.com/MIT-RLX/rlx-models), place this repo under `weights/tts/chatterbox` (or pass the path explicitly), then: |
|
|
| ```bash |
| cargo run -p rlx-chatterbox --release -- --model-dir . |
| ``` |
|
|
| ## License |
|
|
| MIT — see `LICENSE`. Inherit upstream terms when redistributing. |
|
|
| Original weights and authorship: https://huggingface.co/synath/chatterbox-ONNX |
|
|
| ## Maintenance |
|
|
| Cards and LFS attrs are regenerated from the local `weights/` tree in [rlx-models](https://github.com/MIT-RLX/rlx-models) via `python3 scripts/prepare_weights_hf.py`. |
|
|
