Instructions to use bosonai/higgs-tts-2-3b-base with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use bosonai/higgs-tts-2-3b-base with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-to-speech", model="bosonai/higgs-tts-2-3b-base")# Load model directly from transformers import AutoProcessor, AutoModelForTextToWaveform processor = AutoProcessor.from_pretrained("bosonai/higgs-tts-2-3b-base") model = AutoModelForTextToWaveform.from_pretrained("bosonai/higgs-tts-2-3b-base") - Notebooks
- Google Colab
- Kaggle
Update README.md
Browse files
README.md
CHANGED
|
@@ -9,7 +9,7 @@ pipeline_tag: text-to-speech
|
|
| 9 |
library_name: transformers
|
| 10 |
---
|
| 11 |
|
| 12 |
-
# Higgs
|
| 13 |
|
| 14 |
<div align="center" style="display: flex; justify-content: center; margin-top: 10px; flex-wrap: wrap; gap: 8px;">
|
| 15 |
<a href="https://boson.ai/blog/higgs-audio-v2"><img src='https://img.shields.io/badge/🚀-Launch Blogpost-228B22' style="margin-right: 5px;"></a>
|
|
@@ -20,8 +20,10 @@ library_name: transformers
|
|
| 20 |
|
| 21 |
Check our open-source repository https://github.com/boson-ai/higgs-audio for more details!
|
| 22 |
|
| 23 |
-
|
| 24 |
-
|
|
|
|
|
|
|
| 25 |
|
| 26 |
On [EmergentTTS-Eval](https://github.com/boson-ai/emergenttts-eval-public), the model achieves win rates of **75.7%** and **55.7%** over "gpt-4o-mini-tts" on the "Emotions" and "Questions" categories, respectively. It also obtains state-of-the-art performance on traditional TTS benchmarks like Seed-TTS Eval and Emotional Speech Dataset (ESD). Moreover, the model demonstrates capabilities rarely seen in previous systems, including automatic prosody adaptation during narration, zero-shot generation of natural multi-speaker dialogues in multiple languages, melodic humming with the cloned voice, and simultaneous generation of speech and background music.
|
| 27 |
|
|
@@ -54,7 +56,7 @@ Here's another demo video that show-cases the model's multilingual capability an
|
|
| 54 |
<img src="./higgs_audio_v2_architecture_combined.png" width=900>
|
| 55 |
</p>
|
| 56 |
|
| 57 |
-
Higgs
|
| 58 |
|
| 59 |
- We developed an automated annotation pipeline that leverages multiple ASR models, sound event classification models, and our in-house audio understanding model. Using this pipeline, we cleaned and annotated 10 million hours audio data, which we refer to as AudioVerse. The in-house understanding model is finetuned on top of Higgs Audio v1 Understanding, which adopts the "understanding variant" shown in the architecture figure.
|
| 60 |
- We trained a unified audio tokenizer from scratch that captures both semantic and acoustic features.
|
|
@@ -74,22 +76,22 @@ Check https://huggingface.co/bosonai/higgs-audio-v2-tokenizer for more informati
|
|
| 74 |
|
| 75 |
### Model Architecture -- Dual FFN
|
| 76 |
|
| 77 |
-
Higgs
|
| 78 |
we incorporate the "DualFFN" architecture as an audio adapter.
|
| 79 |
DualFFN acts as an audio-specific expert, boosting the LLM's performance with minimal computational overhead.
|
| 80 |
Our implementation preserves 91% of the original LLM’s training speed with the inclusion of DualFFN, which has 2.2B parameters.
|
| 81 |
-
Thus, the total number of parameter for Higgs
|
| 82 |
Ablation study shows that the model equipped with DualFFN consistently outperforms its counterpart in terms of word error rate (WER) and speaker similarity.
|
| 83 |
See [our architecture blog](https://github.com/boson-ai/higgs-audio/blob/main/tech_blogs/ARCHITECTURE_BLOG.md) for more information.
|
| 84 |
|
| 85 |
|
| 86 |
## Evaluation
|
| 87 |
|
| 88 |
-
Here's the performance of Higgs
|
| 89 |
|
| 90 |
#### Seed-TTS Eval & ESD
|
| 91 |
|
| 92 |
-
We prompt Higgs
|
| 93 |
|
| 94 |
| | SeedTTS-Eval| | ESD | |
|
| 95 |
|------------------------------|--------|--------|---------|-------------------|
|
|
@@ -98,16 +100,16 @@ We prompt Higgs Audio v2 with the reference text, reference audio, and target te
|
|
| 98 |
| Qwen2.5-omni† | 2.33 | 64.10 | - | - |
|
| 99 |
| ElevenLabs Multilingual V2 | **1.43** | 50.00 | 1.66 | 65.87 |
|
| 100 |
| Higgs Audio v1 | 2.18 | 66.27 | **1.49** | 82.84 |
|
| 101 |
-
| Higgs
|
| 102 |
|
| 103 |
|
| 104 |
#### EmergentTTS-Eval ("Emotions" and "Questions")
|
| 105 |
|
| 106 |
-
Following the [EmergentTTS-Eval Paper](https://arxiv.org/abs/2505.23009), we report the win-rate over "gpt-4o-mini-tts" with the "alloy" voice. Results of Higgs
|
| 107 |
|
| 108 |
| Model | Emotions (%) ↑ | Questions (%) ↑ |
|
| 109 |
|------------------------------------|--------------|----------------|
|
| 110 |
-
| Higgs
|
| 111 |
| [gpt-4o-audio-preview†](https://platform.openai.com/docs/models/gpt-4o-audio-preview) | 61.64% | 47.85% |
|
| 112 |
| [Hume.AI](https://www.hume.ai/research) | 61.60% | 43.21% |
|
| 113 |
| **BASELINE:** [gpt-4o-mini-tts](https://platform.openai.com/docs/models/gpt-4o-mini-tts) | 50.00% | 50.00% |
|
|
@@ -122,14 +124,14 @@ Following the [EmergentTTS-Eval Paper](https://arxiv.org/abs/2505.23009), we rep
|
|
| 122 |
|
| 123 |
#### Multi-speaker Eval
|
| 124 |
|
| 125 |
-
We also designed a multi-speaker evaluation benchmark to evaluate the capability of Higgs
|
| 126 |
|
| 127 |
- `two-speaker-conversation`: 1000 synthetic dialogues involving two speakers. We fix two reference audio clips to evaluate the model's ability in double voice cloning for utterances ranging from 4 to 10 dialogues between two randomly chosen persona.
|
| 128 |
- `small talk (no ref)`: 250 synthetic dialogues curated in the same way as above, but are characterized by short utterances and a limited number of turns (4–6), we do not fix reference audios in this case and this set is designed to evaluate the model's ability to automatically assign appropriate voices to speakers.
|
| 129 |
- `small talk (ref)`: 250 synthetic dialogues similar to above, but contains even shorter utterances as this set is meant to include reference clips in it's context, similar to `two-speaker-conversation`.
|
| 130 |
|
| 131 |
|
| 132 |
-
We report the word-error-rate (WER) and the geometric mean between intra-speaker similarity and inter-speaker dis-similarity on these three subsets. Other than Higgs
|
| 133 |
Results are summarized in the following table. We are not able to run [nari-labs/Dia-1.6B-0626](https://huggingface.co/nari-labs/Dia-1.6B-0626) on our "two-speaker-conversation" subset due to its strict limitation on the length of the utterances and output audio.
|
| 134 |
|
| 135 |
| | two-speaker-conversation | |small talk | | small talk (no ref) | |
|
|
@@ -137,14 +139,14 @@ Results are summarized in the following table. We are not able to run [nari-labs
|
|
| 137 |
| | WER ↓ | Mean Sim & Dis-sim ↑ | WER ↓ | Mean Sim & Dis-sim ↑ | WER ↓ | Mean Sim & Dis-sim ↑ |
|
| 138 |
| [MoonCast](https://github.com/jzq2000/MoonCast) | 38.77 | 46.02 | **8.33** | 63.68 | 24.65 | 53.94 |
|
| 139 |
| [nari-labs/Dia-1.6B-0626](https://huggingface.co/nari-labs/Dia-1.6B-0626) | \- | \- | 17.62 | 63.15 | 19.46 | **61.14** |
|
| 140 |
-
| Higgs
|
| 141 |
|
| 142 |
|
| 143 |
## Usage
|
| 144 |
|
| 145 |
### Transformers 🤗
|
| 146 |
|
| 147 |
-
Higgs
|
| 148 |
|
| 149 |
```bash
|
| 150 |
uv pip install "transformers>=5.3.0"
|
|
@@ -600,4 +602,4 @@ You can also check https://github.com/boson-ai/higgs-audio/tree/main/examples fo
|
|
| 600 |
|
| 601 |
## License
|
| 602 |
|
| 603 |
-
See [LICENSE](./LICENSE)
|
|
|
|
| 9 |
library_name: transformers
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# Higgs TTS 2: Redefining Expressiveness in Audio Generation
|
| 13 |
|
| 14 |
<div align="center" style="display: flex; justify-content: center; margin-top: 10px; flex-wrap: wrap; gap: 8px;">
|
| 15 |
<a href="https://boson.ai/blog/higgs-audio-v2"><img src='https://img.shields.io/badge/🚀-Launch Blogpost-228B22' style="margin-right: 5px;"></a>
|
|
|
|
| 20 |
|
| 21 |
Check our open-source repository https://github.com/boson-ai/higgs-audio for more details!
|
| 22 |
|
| 23 |
+
> **Rename note:** Higgs Audio V2 and Higgs Audio V2 Generation have been renamed to Higgs TTS 2.
|
| 24 |
+
|
| 25 |
+
We are open-sourcing Higgs TTS 2, a powerful audio foundation model pretrained on over 10 million hours of audio data and a diverse set of text data.
|
| 26 |
+
Despite having no post-training or fine-tuning, Higgs TTS 2 excels in expressive audio generation, thanks to its deep language and acoustic understanding.
|
| 27 |
|
| 28 |
On [EmergentTTS-Eval](https://github.com/boson-ai/emergenttts-eval-public), the model achieves win rates of **75.7%** and **55.7%** over "gpt-4o-mini-tts" on the "Emotions" and "Questions" categories, respectively. It also obtains state-of-the-art performance on traditional TTS benchmarks like Seed-TTS Eval and Emotional Speech Dataset (ESD). Moreover, the model demonstrates capabilities rarely seen in previous systems, including automatic prosody adaptation during narration, zero-shot generation of natural multi-speaker dialogues in multiple languages, melodic humming with the cloned voice, and simultaneous generation of speech and background music.
|
| 29 |
|
|
|
|
| 56 |
<img src="./higgs_audio_v2_architecture_combined.png" width=900>
|
| 57 |
</p>
|
| 58 |
|
| 59 |
+
Higgs TTS 2 adopts the "generation variant" depicted in the architecture figure above. Its strong performance is driven by three key technical innovations:
|
| 60 |
|
| 61 |
- We developed an automated annotation pipeline that leverages multiple ASR models, sound event classification models, and our in-house audio understanding model. Using this pipeline, we cleaned and annotated 10 million hours audio data, which we refer to as AudioVerse. The in-house understanding model is finetuned on top of Higgs Audio v1 Understanding, which adopts the "understanding variant" shown in the architecture figure.
|
| 62 |
- We trained a unified audio tokenizer from scratch that captures both semantic and acoustic features.
|
|
|
|
| 76 |
|
| 77 |
### Model Architecture -- Dual FFN
|
| 78 |
|
| 79 |
+
Higgs TTS 2 is built on top of [Llama-3.2-3B](https://huggingface.co/meta-llama/Llama-3.2-3B). To enhance the model’s ability to process audio tokens,
|
| 80 |
we incorporate the "DualFFN" architecture as an audio adapter.
|
| 81 |
DualFFN acts as an audio-specific expert, boosting the LLM's performance with minimal computational overhead.
|
| 82 |
Our implementation preserves 91% of the original LLM’s training speed with the inclusion of DualFFN, which has 2.2B parameters.
|
| 83 |
+
Thus, the total number of parameter for Higgs TTS 2 is 3.6B (LLM) + 2.2B (Audio Dual FFN), and it has the same training / inference FLOPs as Llama-3.2-3B.
|
| 84 |
Ablation study shows that the model equipped with DualFFN consistently outperforms its counterpart in terms of word error rate (WER) and speaker similarity.
|
| 85 |
See [our architecture blog](https://github.com/boson-ai/higgs-audio/blob/main/tech_blogs/ARCHITECTURE_BLOG.md) for more information.
|
| 86 |
|
| 87 |
|
| 88 |
## Evaluation
|
| 89 |
|
| 90 |
+
Here's the performance of Higgs TTS 2 on four benchmarks, [Seed-TTS Eval](https://github.com/BytedanceSpeech/seed-tts-eval), [Emotional Speech Dataset (ESD)](https://paperswithcode.com/dataset/esd), [EmergentTTS-Eval](https://arxiv.org/abs/2505.23009), and Multi-speaker Eval:
|
| 91 |
|
| 92 |
#### Seed-TTS Eval & ESD
|
| 93 |
|
| 94 |
+
We prompt Higgs TTS 2 with the reference text, reference audio, and target text for zero-shot TTS. We use the standard evaluation metrics from Seed-TTS Eval and ESD.
|
| 95 |
|
| 96 |
| | SeedTTS-Eval| | ESD | |
|
| 97 |
|------------------------------|--------|--------|---------|-------------------|
|
|
|
|
| 100 |
| Qwen2.5-omni† | 2.33 | 64.10 | - | - |
|
| 101 |
| ElevenLabs Multilingual V2 | **1.43** | 50.00 | 1.66 | 65.87 |
|
| 102 |
| Higgs Audio v1 | 2.18 | 66.27 | **1.49** | 82.84 |
|
| 103 |
+
| Higgs TTS 2 (base) | 2.44 | **67.70** | 1.78 | **86.13** |
|
| 104 |
|
| 105 |
|
| 106 |
#### EmergentTTS-Eval ("Emotions" and "Questions")
|
| 107 |
|
| 108 |
+
Following the [EmergentTTS-Eval Paper](https://arxiv.org/abs/2505.23009), we report the win-rate over "gpt-4o-mini-tts" with the "alloy" voice. Results of Higgs TTS 2 are obtained with the voice of "belinda". The judge model is Gemini 2.5 Pro.
|
| 109 |
|
| 110 |
| Model | Emotions (%) ↑ | Questions (%) ↑ |
|
| 111 |
|------------------------------------|--------------|----------------|
|
| 112 |
+
| Higgs TTS 2 (base) | **75.71%** | **55.71%** |
|
| 113 |
| [gpt-4o-audio-preview†](https://platform.openai.com/docs/models/gpt-4o-audio-preview) | 61.64% | 47.85% |
|
| 114 |
| [Hume.AI](https://www.hume.ai/research) | 61.60% | 43.21% |
|
| 115 |
| **BASELINE:** [gpt-4o-mini-tts](https://platform.openai.com/docs/models/gpt-4o-mini-tts) | 50.00% | 50.00% |
|
|
|
|
| 124 |
|
| 125 |
#### Multi-speaker Eval
|
| 126 |
|
| 127 |
+
We also designed a multi-speaker evaluation benchmark to evaluate the capability of Higgs TTS 2 for multi-speaker dialog generation. The benchmark contains three subsets
|
| 128 |
|
| 129 |
- `two-speaker-conversation`: 1000 synthetic dialogues involving two speakers. We fix two reference audio clips to evaluate the model's ability in double voice cloning for utterances ranging from 4 to 10 dialogues between two randomly chosen persona.
|
| 130 |
- `small talk (no ref)`: 250 synthetic dialogues curated in the same way as above, but are characterized by short utterances and a limited number of turns (4–6), we do not fix reference audios in this case and this set is designed to evaluate the model's ability to automatically assign appropriate voices to speakers.
|
| 131 |
- `small talk (ref)`: 250 synthetic dialogues similar to above, but contains even shorter utterances as this set is meant to include reference clips in it's context, similar to `two-speaker-conversation`.
|
| 132 |
|
| 133 |
|
| 134 |
+
We report the word-error-rate (WER) and the geometric mean between intra-speaker similarity and inter-speaker dis-similarity on these three subsets. Other than Higgs TTS 2, we also evaluated [MoonCast](https://github.com/jzq2000/MoonCast) and [nari-labs/Dia-1.6B-0626](https://huggingface.co/nari-labs/Dia-1.6B-0626), two of the most popular open-source models capable of multi-speaker dialog generation.
|
| 135 |
Results are summarized in the following table. We are not able to run [nari-labs/Dia-1.6B-0626](https://huggingface.co/nari-labs/Dia-1.6B-0626) on our "two-speaker-conversation" subset due to its strict limitation on the length of the utterances and output audio.
|
| 136 |
|
| 137 |
| | two-speaker-conversation | |small talk | | small talk (no ref) | |
|
|
|
|
| 139 |
| | WER ↓ | Mean Sim & Dis-sim ↑ | WER ↓ | Mean Sim & Dis-sim ↑ | WER ↓ | Mean Sim & Dis-sim ↑ |
|
| 140 |
| [MoonCast](https://github.com/jzq2000/MoonCast) | 38.77 | 46.02 | **8.33** | 63.68 | 24.65 | 53.94 |
|
| 141 |
| [nari-labs/Dia-1.6B-0626](https://huggingface.co/nari-labs/Dia-1.6B-0626) | \- | \- | 17.62 | 63.15 | 19.46 | **61.14** |
|
| 142 |
+
| Higgs TTS 2 (base) | **18.88** | **51.95** | 11.89 | **67.92** | **14.65** | 55.28 |
|
| 143 |
|
| 144 |
|
| 145 |
## Usage
|
| 146 |
|
| 147 |
### Transformers 🤗
|
| 148 |
|
| 149 |
+
Higgs TTS 2 is supported natively in `transformers`: [see the doc](https://huggingface.co/docs/transformers/en/model_doc/higgs_audio_v2).
|
| 150 |
|
| 151 |
```bash
|
| 152 |
uv pip install "transformers>=5.3.0"
|
|
|
|
| 602 |
|
| 603 |
## License
|
| 604 |
|
| 605 |
+
See [LICENSE](./LICENSE)
|