Text-to-Speech
Safetensors
MLX
mlx-audio
moonbox
fish-audio
fish-speech
s2-pro
voice-cloning
multilingual
Instructions to use moonbox-dev/s2-pro-MLX with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use moonbox-dev/s2-pro-MLX with MLX:
# Download the model from the Hub pip install huggingface_hub[hf_xet] hf download moonbox-dev/s2-pro-MLX --local-dir s2-pro-MLX
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
Model card and the original license
Browse files- .gitattributes +1 -0
- LICENSE.md +94 -0
- NOTICE.md +8 -0
- README.md +165 -0
- overview.png +3 -0
.gitattributes
CHANGED
|
@@ -34,3 +34,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
bf16/tokenizer.json filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
bf16/tokenizer.json filter=lfs diff=lfs merge=lfs -text
|
| 37 |
+
overview.png filter=lfs diff=lfs merge=lfs -text
|
LICENSE.md
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# FISH AUDIO RESEARCH LICENSE AGREEMENT
|
| 2 |
+
|
| 3 |
+
**Last Updated: March 7, 2026**
|
| 4 |
+
|
| 5 |
+
## I. INTRODUCTION
|
| 6 |
+
|
| 7 |
+
This Agreement applies to any individual person or entity ("You", "Your" or "Licensee") that uses or distributes any portion or element of the Fish Audio Materials or Derivative Works thereof for any Research, Non-Commercial, or Commercial purpose. Capitalized terms not otherwise defined herein are defined in Section V below.
|
| 8 |
+
|
| 9 |
+
This Agreement is intended to allow research and non-commercial uses of the Materials free of charge. Any Commercial use of the Materials requires a separate license from Fish Audio.
|
| 10 |
+
|
| 11 |
+
By clicking "I Accept" or by using, distributing, or accessing any portion or element of the Fish Audio Materials or Derivative Works, You agree that You have read, understood and are bound by the terms of this Agreement. If You are acting on behalf of a company, organization or other entity, then "You" includes you and that entity, and You agree that You: (i) are an authorized representative of such entity with the authority to bind such entity to this Agreement, and (ii) You agree to the terms of this Agreement on that entity's behalf.
|
| 12 |
+
|
| 13 |
+
## II. RESEARCH & NON-COMMERCIAL USE LICENSE
|
| 14 |
+
|
| 15 |
+
Subject to the terms of this Agreement, Fish Audio grants You a non-exclusive, worldwide, non-transferable, non-sublicensable, revocable and royalty-free limited license under Fish Audio's intellectual property or other rights owned by Fish Audio embodied in the Fish Audio Materials to use, reproduce, distribute, and create Derivative Works of, and make modifications to, the Fish Audio Materials for any Research or Non-Commercial Purpose.
|
| 16 |
+
|
| 17 |
+
"Research Purpose" means academic or scientific advancement, and in each case, is not primarily intended for commercial advantage or monetary compensation to You or others.
|
| 18 |
+
|
| 19 |
+
"Non-Commercial Purpose" means any purpose other than a Research Purpose that is not primarily intended for commercial advantage or monetary compensation to You or others, such as personal use (i.e., hobbyist) or evaluation and testing.
|
| 20 |
+
|
| 21 |
+
## III. COMMERCIAL USE
|
| 22 |
+
|
| 23 |
+
**Any use of the Fish Audio Materials or Derivative Works for a Commercial Purpose requires a separate written license agreement from Fish Audio.** No commercial rights are granted under this Agreement.
|
| 24 |
+
|
| 25 |
+
"Commercial Purpose" means any purpose other than a Research Purpose or Non-Commercial Purpose that is primarily intended for or directed toward commercial advantage or monetary compensation to You or others, including but not limited to: (i) creating, modifying, or distributing Your product or service, including via a hosted service or application programming interface, (ii) Your business's or organization's internal operations, and (iii) any use in connection with a product or service for which You charge a fee or generate revenue, whether directly or indirectly.
|
| 26 |
+
|
| 27 |
+
To obtain a commercial license, please contact Fish Audio at:
|
| 28 |
+
|
| 29 |
+
- **Website:** [https://fish.audio](https://fish.audio)
|
| 30 |
+
- **Email:** business@fish.audio
|
| 31 |
+
|
| 32 |
+
## IV. GENERAL TERMS
|
| 33 |
+
|
| 34 |
+
Your Research and Non-Commercial License under this Agreement is subject to the following terms.
|
| 35 |
+
|
| 36 |
+
### a. Distribution & Attribution
|
| 37 |
+
|
| 38 |
+
If You distribute or make available the Fish Audio Materials or a Derivative Work to a third party, or a product or service that uses any portion of them, You shall: (i) provide a copy of this Agreement to that third party, (ii) retain the following attribution notice within a "Notice" text file distributed as a part of such copies: "This model is licensed under the Fish Audio Research License, Copyright © 39 AI, INC. All Rights Reserved.", and (iii) prominently display "Built with Fish Audio" on a related website, user interface, blogpost, about page, or product documentation.
|
| 39 |
+
|
| 40 |
+
If You create a Derivative Work, You may add your own attribution notice(s) to the "Notice" text file included with that Derivative Work, provided that You clearly indicate which attributions apply to the Fish Audio Materials and state in the "Notice" text file that You changed the Fish Audio Materials and how it was modified.
|
| 41 |
+
|
| 42 |
+
### b. Use Restrictions
|
| 43 |
+
|
| 44 |
+
Your use of the Fish Audio Materials and Derivative Works, including any output or results of the Fish Audio Materials or Derivative Works, must comply with applicable laws and regulations (including Trade Control Laws and equivalent regulations) and adhere to Fish Audio's Acceptable Use Policy, which is hereby incorporated by reference.
|
| 45 |
+
|
| 46 |
+
Furthermore, You will not use the Fish Audio Materials or Derivative Works, or any output or results of the Fish Audio Materials or Derivative Works, to create or improve any foundational generative AI model (excluding the Models or Derivative Works).
|
| 47 |
+
|
| 48 |
+
### c. Intellectual Property
|
| 49 |
+
|
| 50 |
+
**(i) Trademark License.** No trademark licenses are granted under this Agreement, and in connection with the Fish Audio Materials or Derivative Works, You may not use any name or mark owned by or associated with Fish Audio or any of its Affiliates, except as required under Section IV(a) herein.
|
| 51 |
+
|
| 52 |
+
**(ii) Ownership of Derivative Works.** As between You and Fish Audio, You are the owner of Derivative Works You create, subject to Fish Audio's ownership of the Fish Audio Materials and any Derivative Works made by or for Fish Audio.
|
| 53 |
+
|
| 54 |
+
**(iii) Ownership of Outputs.** As between You and Fish Audio, You own any outputs generated from the Models or Derivative Works to the extent permitted by applicable law.
|
| 55 |
+
|
| 56 |
+
**(iv) Disputes.** If You or Your Affiliate(s) institute litigation or other proceedings against Fish Audio (including a cross-claim or counterclaim in a lawsuit) alleging that the Fish Audio Materials, Derivative Works or associated outputs or results, or any portion of any of the foregoing, constitutes infringement of intellectual property or other rights owned or licensable by You, then any licenses granted to You under this Agreement shall terminate as of the date such litigation or claim is filed or instituted. You will indemnify and hold harmless Fish Audio from and against any claim by any third party arising out of or related to Your use or distribution of the Fish Audio Materials or Derivative Works in violation of this Agreement.
|
| 57 |
+
|
| 58 |
+
**(v) Feedback.** From time to time, You may provide Fish Audio with verbal and/or written suggestions, comments or other feedback related to Fish Audio's existing or prospective technology, products or services (collectively, "Feedback"). You are not obligated to provide Fish Audio with Feedback, but to the extent that You do, You hereby grant Fish Audio a perpetual, irrevocable, royalty-free, fully-paid, sub-licensable, transferable, non-exclusive, worldwide right and license to exploit the Feedback in any manner without restriction. Your Feedback is provided "AS IS" and You make no warranties whatsoever about any Feedback.
|
| 59 |
+
|
| 60 |
+
### d. Disclaimer of Warranty
|
| 61 |
+
|
| 62 |
+
UNLESS REQUIRED BY APPLICABLE LAW, THE FISH AUDIO MATERIALS AND ANY OUTPUT AND RESULTS THEREFROM ARE PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. YOU ARE SOLELY RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OR LAWFULNESS OF USING OR REDISTRIBUTING THE FISH AUDIO MATERIALS, DERIVATIVE WORKS OR ANY OUTPUT OR RESULTS AND ASSUME ANY RISKS ASSOCIATED WITH YOUR USE OF THE FISH AUDIO MATERIALS, DERIVATIVE WORKS AND ANY OUTPUT AND RESULTS.
|
| 63 |
+
|
| 64 |
+
### e. Limitation of Liability
|
| 65 |
+
|
| 66 |
+
IN NO EVENT WILL FISH AUDIO OR ITS AFFILIATES BE LIABLE UNDER ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, TORT, NEGLIGENCE, PRODUCTS LIABILITY, OR OTHERWISE, ARISING OUT OF THIS AGREEMENT, FOR ANY LOST PROFITS OR ANY DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL, EXEMPLARY OR PUNITIVE DAMAGES, EVEN IF FISH AUDIO OR ITS AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF ANY OF THE FOREGOING.
|
| 67 |
+
|
| 68 |
+
### f. Term and Termination
|
| 69 |
+
|
| 70 |
+
The term of this Agreement will commence upon Your acceptance of this Agreement or access to the Fish Audio Materials and will continue in full force and effect until terminated in accordance with the terms and conditions herein. Fish Audio may terminate this Agreement if You are in breach of any term or condition of this Agreement. Upon termination of this Agreement, You shall delete and cease use of any Fish Audio Materials or Derivative Works. Sections IV(d), (e), and (g) shall survive the termination of this Agreement.
|
| 71 |
+
|
| 72 |
+
### g. Governing Law
|
| 73 |
+
|
| 74 |
+
This Agreement will be governed by and construed in accordance with the laws of the United States and the State of California without regard to choice of law principles, and the UN Convention on Contracts for International Sale of Goods does not apply to this Agreement.
|
| 75 |
+
|
| 76 |
+
## V. DEFINITIONS
|
| 77 |
+
|
| 78 |
+
**"Affiliate(s)"** means any entity that directly or indirectly controls, is controlled by, or is under common control with the subject entity; for purposes of this definition, "control" means direct or indirect ownership or control of more than 50% of the voting interests of the subject entity.
|
| 79 |
+
|
| 80 |
+
**"Agreement"** means this Fish Audio Research License Agreement.
|
| 81 |
+
|
| 82 |
+
**"Derivative Work(s)"** means (a) any derivative work of the Fish Audio Materials as recognized by U.S. copyright laws and (b) any modifications to a Model, and any other model created which is based on or derived from the Model or the Model's output, including "fine tune" and "low-rank adaptation" models derived from a Model or a Model's output, but do not include the output of any Model.
|
| 83 |
+
|
| 84 |
+
**"Documentation"** means any specifications, manuals, documentation, and other written information provided by Fish Audio related to the Software or Models.
|
| 85 |
+
|
| 86 |
+
**"Fish Audio"** or **"we"** means 39 AI, INC. and its Affiliates.
|
| 87 |
+
|
| 88 |
+
**"Model(s)"** means, collectively, Fish Audio's proprietary models and algorithms, including machine-learning models, trained model weights and other elements of the foregoing.
|
| 89 |
+
|
| 90 |
+
**"Software"** means Fish Audio's proprietary software made available under this Agreement now or in the future.
|
| 91 |
+
|
| 92 |
+
**"Fish Audio Materials"** means, collectively, Fish Audio's proprietary Models, Software and Documentation (and any portion or combination thereof) made available under this Agreement.
|
| 93 |
+
|
| 94 |
+
**"Trade Control Laws"** means any applicable U.S. and non-U.S. export control and trade sanctions laws and regulations.
|
NOTICE.md
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
This model is licensed under the Fish Audio Research License, Copyright © 39 AI, INC. All Rights Reserved.
|
| 2 |
+
|
| 3 |
+
Built with Fish Audio.
|
| 4 |
+
|
| 5 |
+
Changes by Moonbox (moonbox-dev): the weights of fishaudio/s2-pro (revision 1de9996b6be38b745688de084d87a5633f714e4e)
|
| 6 |
+
were converted to MLX for mlx-audio: stored as bf16 or fp16, or with the transformer layers quantized to 8, 6 or 4
|
| 7 |
+
bits (MLX affine, group size 64); the codec (codec.pth) was re-saved as codec.safetensors (float32, unchanged values).
|
| 8 |
+
Nothing was retrained or fine-tuned.
|
README.md
ADDED
|
@@ -0,0 +1,165 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
base_model: fishaudio/s2-pro
|
| 3 |
+
base_model_relation: quantized
|
| 4 |
+
license: other
|
| 5 |
+
license_name: fish-audio-research-license
|
| 6 |
+
license_link: LICENSE.md
|
| 7 |
+
pipeline_tag: text-to-speech
|
| 8 |
+
library_name: mlx-audio
|
| 9 |
+
tags:
|
| 10 |
+
- mlx
|
| 11 |
+
- moonbox
|
| 12 |
+
- mlx-audio
|
| 13 |
+
- fish-audio
|
| 14 |
+
- fish-speech
|
| 15 |
+
- s2-pro
|
| 16 |
+
- text-to-speech
|
| 17 |
+
- voice-cloning
|
| 18 |
+
- multilingual
|
| 19 |
+
---
|
| 20 |
+
|
| 21 |
+
# Fish Audio S2 Pro MLX
|
| 22 |
+
|
| 23 |
+
MLX builds of [Fish Audio S2 Pro](https://huggingface.co/fishaudio/s2-pro), made by Moonbox for Apple Silicon Macs. Each precision is a folder; keep a folder's
|
| 24 |
+
files together. Only the parts listed below are converted: the rest of the pipeline comes from the original
|
| 25 |
+
repository unless the section below says otherwise.
|
| 26 |
+
|
| 27 |
+
## Files
|
| 28 |
+
|
| 29 |
+
The last column is how far each build is from the original PyTorch model on the same inputs (see the section below
|
| 30 |
+
for what was measured).
|
| 31 |
+
|
| 32 |
+
| Precision | File | Size | sha256 | Checked against the original |
|
| 33 |
+
|---|---|---|---|---|
|
| 34 |
+
| bf16 | [`bf16/chat_template.jinja`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/chat_template.jinja) | 4.1 kB | `87a2728cb8dc` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 35 |
+
| bf16 | [`bf16/codec.safetensors`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/codec.safetensors) | 2.78 GB | `fde06aa1f23b` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 36 |
+
| bf16 | [`bf16/config.json`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/config.json) | 2.1 kB | `870046f617ca` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 37 |
+
| bf16 | [`bf16/model-00001-of-00002.safetensors`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/model-00001-of-00002.safetensors) | 5.35 GB | `13c1b614ac67` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 38 |
+
| bf16 | [`bf16/model-00002-of-00002.safetensors`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/model-00002-of-00002.safetensors) | 3.78 GB | `a75a5d2e91dd` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 39 |
+
| bf16 | [`bf16/model.safetensors.index.json`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/model.safetensors.index.json) | 30.4 kB | `65dc730b4e46` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 40 |
+
| bf16 | [`bf16/special_tokens_map.json`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/special_tokens_map.json) | 0.1 MB | `c2ff18fde6e4` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 41 |
+
| bf16 | [`bf16/tokenizer.json`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/tokenizer.json) | 12.2 MB | `f24e08099d45` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 42 |
+
| bf16 | [`bf16/tokenizer_config.json`](https://huggingface.co/moonbox-dev/s2-pro-MLX/blob/main/bf16/tokenizer_config.json) | 0.9 MB | `b8d149343ae4` | WER 0.0 % / CER 0.0 %, speaker sim 0.956 / 0.952, DNSMOS 3.24 / 2.92 (original 0.0 % / 0.0 %, 0.952 / 0.949, 3.21 / 2.76) |
|
| 43 |
+
|
| 44 |
+
## How to run
|
| 45 |
+
|
| 46 |
+
Fish Audio S2 Pro (4.4B dual-autoregressive TTS: voice cloning, 80+ languages, inline `[tag]` control of emotion and
|
| 47 |
+
prosody) for [mlx-audio](https://github.com/Blaizzy/mlx-audio). **Built with Fish Audio.** Each folder is a complete
|
| 48 |
+
mlx-audio model: `model-*.safetensors` (slow and fast AR transformers), `codec.safetensors` (the DAC codec, float32,
|
| 49 |
+
re-saved unchanged from the original `codec.pth`), the tokenizer and chat template. Tested with `mlx-audio==0.6.5`:
|
| 50 |
+
|
| 51 |
+
```python
|
| 52 |
+
from mlx_audio.tts.utils import load_model
|
| 53 |
+
import mlx.core as mx, numpy as np, soundfile as sf, librosa
|
| 54 |
+
|
| 55 |
+
model = load_model("8bit") # a downloaded folder
|
| 56 |
+
ref = mx.array(librosa.load("voice.wav", sr=model.sample_rate)[0])
|
| 57 |
+
res = list(model.generate(text="Hello from Moonbox.", ref_audio=ref, ref_text="Exact transcript of voice.wav."))
|
| 58 |
+
sf.write("out.wav", np.concatenate([np.array(r.audio) for r in res]), res[0].sample_rate)
|
| 59 |
+
```
|
| 60 |
+
|
| 61 |
+
`8bit/`, `6bit/` and `4bit/` quantize the transformer layers (MLX affine, group size 64); the codec is not quantized.
|
| 62 |
+
**License:** Fish Audio Research License: research and non-commercial use only; commercial use needs a license from
|
| 63 |
+
Fish Audio. See `LICENSE.md` and `NOTICE.md` (what was changed).
|
| 64 |
+
|
| 65 |
+
**How they were checked.** Voice cloning of 6 English and 4 Chinese sentences, two seeds each, with the original
|
| 66 |
+
(fish-speech's own inference code, PyTorch bfloat16) and every MLX build, the original's sampling (temperature 0.7,
|
| 67 |
+
top-p 0.7, top-k 30). Judged like the original: Whisper large-v3-turbo WER / CER, WavLM speaker similarity to the
|
| 68 |
+
prompt, DNSMOS. Pass: error rate at most 2 points above the original's, similarity at most 0.03 below, DNSMOS at most
|
| 69 |
+
0.2 below.
|
| 70 |
+
|
| 71 |
+
| Precision | Size | WER en / CER zh | Speaker similarity en / zh | DNSMOS en / zh | Real-time factor, M5 24 GB |
|
| 72 |
+
|---|---|---|---|---|---|
|
| 73 |
+
| original (PyTorch bf16, MPS) | - | 0.0 % / 0.0 % | 0.952 / 0.949 | 3.21 / 2.76 | 4.2 |
|
| 74 |
+
| `bf16/` | 11.9 GB | 0.0 % / 0.0 % | 0.956 / 0.952 | 3.24 / 2.92 | ~5 |
|
| 75 |
+
| `fp16/` | 11.9 GB | 0.0 % / 0.0 % | 0.964 / 0.951 | 3.21 / 2.86 | 4.7 |
|
| 76 |
+
| `8bit/` | 8.5 GB | 0.0 % / 0.0 % | 0.953 / 0.953 | 3.22 / 2.83 | 3.2 |
|
| 77 |
+
| `6bit/` | 7.6 GB | 0.0 % / 0.0 % | 0.966 / 0.945 | 3.24 / 2.80 | 3.1 |
|
| 78 |
+
| `4bit/` | 6.7 GB | 0.0 % / 0.0 % | 0.963 / 0.944 | 3.22 / 3.01 | 3.0 |
|
| 79 |
+
|
| 80 |
+
Real-time factor = generation time / audio length, one sentence at a time (slower than real time on a 24 GB M5).
|
| 81 |
+
|
| 82 |
+
## How these were made
|
| 83 |
+
|
| 84 |
+
From [Fish Audio S2 Pro](https://huggingface.co/fishaudio/s2-pro) at revision `1de9996b6b`: the original weights loaded in MLX and stored as bf16 or fp16, or
|
| 85 |
+
quantized with MLX's affine quantization (`8bit`, `6bit`, `4bit`, group size 64; layers MLX can't quantize, such as
|
| 86 |
+
convolutions and norms, stay bf16). Every build was checked against the original before upload; the `sha256` column
|
| 87 |
+
above is what the files must hash to.
|
| 88 |
+
|
| 89 |
+
## License
|
| 90 |
+
|
| 91 |
+
other (Fish Audio research license). These files are a derivative of the original model and carry its license: it is copied in this
|
| 92 |
+
repository, and it governs your use of these files. The original model card follows unchanged.
|
| 93 |
+
|
| 94 |
+
---
|
| 95 |
+
|
| 96 |
+
# Original model card
|
| 97 |
+
|
| 98 |
+
# Fish Audio S2 Pro
|
| 99 |
+
|
| 100 |
+
<img src="overview.png" alt="Fish Audio S2 Pro overview — fine-grained control, multi-speaker multi-turn generation, low-latency streaming, and long-context inference." width="100%">
|
| 101 |
+
|
| 102 |
+
[**Technical Report**](https://huggingface.co/papers/2603.08823) | [**GitHub**](https://github.com/fishaudio/fish-speech) | [**Playground**](https://fish.audio)
|
| 103 |
+
|
| 104 |
+
**Fish Audio S2 Pro** is a leading text-to-speech (TTS) model with fine-grained inline control of prosody and emotion. Trained on over 10M+ hours of audio data across 80+ languages, the system combines reinforcement learning alignment with a dual-autoregressive architecture. The release includes model weights, fine-tuning code, and an SGLang-based streaming inference engine.
|
| 105 |
+
|
| 106 |
+
## Architecture
|
| 107 |
+
|
| 108 |
+
S2 Pro builds on a decoder-only transformer combined with an RVQ-based audio codec (10 codebooks, ~21 Hz frame rate) using a **Dual-Autoregressive (Dual-AR)** architecture:
|
| 109 |
+
|
| 110 |
+
- **Slow AR** (4B parameters): Operates along the time axis and predicts the primary semantic codebook.
|
| 111 |
+
- **Fast AR** (400M parameters): Generates the remaining 9 residual codebooks at each time step, reconstructing fine-grained acoustic detail.
|
| 112 |
+
|
| 113 |
+
This asymmetric design keeps inference efficient while preserving audio fidelity. Because the Dual-AR architecture is structurally isomorphic to standard autoregressive LLMs, it inherits all LLM-native serving optimizations from SGLang — including continuous batching, paged KV cache, CUDA graph replay, and RadixAttention-based prefix caching.
|
| 114 |
+
|
| 115 |
+
## Fine-Grained Inline Control
|
| 116 |
+
|
| 117 |
+
S2 Pro enables localized control over speech generation by embedding natural-language instructions directly within the text using `[tag]` syntax. Rather than relying on a fixed set of predefined tags, S2 Pro accepts **free-form textual descriptions** — such as `[whisper in small voice]`, `[professional broadcast tone]`, or `[pitch up]` — allowing open-ended expression control at the word level.
|
| 118 |
+
|
| 119 |
+
**Common tags (15,000+ unique tags supported):**
|
| 120 |
+
|
| 121 |
+
`[pause]` `[emphasis]` `[laughing]` `[inhale]` `[chuckle]` `[tsk]` `[singing]` `[excited]` `[laughing tone]` `[interrupting]` `[chuckling]` `[excited tone]` `[volume up]` `[echo]` `[angry]` `[low volume]` `[sigh]` `[low voice]` `[whisper]` `[screaming]` `[shouting]` `[loud]` `[surprised]` `[short pause]` `[exhale]` `[delight]` `[panting]` `[audience laughter]` `[with strong accent]` `[volume down]` `[clearing throat]` `[sad]` `[moaning]` `[shocked]`
|
| 122 |
+
|
| 123 |
+
## Supported Languages
|
| 124 |
+
|
| 125 |
+
S2 Pro supports 80+ languages.
|
| 126 |
+
|
| 127 |
+
**Tier 1:** Japanese (ja), English (en), Chinese (zh)
|
| 128 |
+
|
| 129 |
+
**Tier 2:** Korean (ko), Spanish (es), Portuguese (pt), Arabic (ar), Russian (ru), French (fr), German (de)
|
| 130 |
+
|
| 131 |
+
**Other supported languages:** sv, it, tr, no, nl, cy, eu, ca, da, gl, ta, hu, fi, pl, et, hi, la, ur, th, vi, jw, bn, yo, xsl, cs, sw, nn, he, ms, uk, id, kk, bg, lv, my, tl, sk, ne, fa, af, el, bo, hr, ro, sn, mi, yi, am, be, km, is, az, sd, br, sq, ps, mn, ht, ml, sr, sa, te, ka, bs, pa, lt, kn, si, hy, mr, as, gu, fo, and more.
|
| 132 |
+
|
| 133 |
+
## Production Streaming Performance
|
| 134 |
+
|
| 135 |
+
On a single NVIDIA H200 GPU:
|
| 136 |
+
|
| 137 |
+
- **Real-Time Factor (RTF):** 0.195
|
| 138 |
+
- **Time-to-first-audio:** ~100 ms
|
| 139 |
+
- **Throughput:** 3,000+ acoustic tokens/s while maintaining RTF below 0.5
|
| 140 |
+
|
| 141 |
+
## Links
|
| 142 |
+
|
| 143 |
+
- [Fish Speech GitHub](https://github.com/fishaudio/fish-speech)
|
| 144 |
+
- [Fish Audio Playground](https://fish.audio)
|
| 145 |
+
- [Blog & Tech Report](https://fish.audio/blog/fish-audio-open-sources-s2/)
|
| 146 |
+
|
| 147 |
+
## Technical Report
|
| 148 |
+
|
| 149 |
+
If you find our work useful, please consider citing our report:
|
| 150 |
+
|
| 151 |
+
```bibtex
|
| 152 |
+
@misc{liao2026fishaudios2technical,
|
| 153 |
+
title={Fish Audio S2 Technical Report},
|
| 154 |
+
author={Shijia Liao and Yuxuan Wang and Songting Liu and Yifan Cheng and Ruoyi Zhang and Tianyu Li and Shidong Li and Yisheng Zheng and Xingwei Liu and Qingzheng Wang and Zhizhuo Zhou and Jiahua Liu and Xin Chen and Dawei Han},
|
| 155 |
+
year={2026},
|
| 156 |
+
eprint={2603.08823},
|
| 157 |
+
archivePrefix={arXiv},
|
| 158 |
+
primaryClass={cs.SD},
|
| 159 |
+
url={https://arxiv.org/abs/2603.08823},
|
| 160 |
+
}
|
| 161 |
+
```
|
| 162 |
+
|
| 163 |
+
## License
|
| 164 |
+
|
| 165 |
+
This model is licensed under the [Fish Audio Research License](LICENSE.md). Research and non-commercial use is permitted free of charge. Commercial use requires a separate license from Fish Audio — contact business@fish.audio.
|
overview.png
ADDED
|
Git LFS Details
|