| --- |
| license: mit |
| language: |
| - multilingual |
| tags: |
| - text-to-speech |
| - speech-synthesis |
| - hebrew |
| pipeline_tag: text-to-speech |
| --- |
| |
| # Blue — PyTorch weights (training, finetuning & voice export) |
|
|
| This repository contains **Safetensors / PyTorch checkpoints** and **multilingual latent statistics** for **[BlueTTS](https://github.com/maxmelichov/BlueTTS)** — Hebrew-first multilingual text-to-speech with optional English, Spanish, Italian, German, and mixed-language synthesis in the reference code. |
|
|
| **Project home (install, ONNX inference, examples):** [https://github.com/maxmelichov/BlueTTS](https://github.com/maxmelichov/BlueTTS) |
|
|
| **Live ONNX demo (browser):** [Hugging Face Space — notmax123/Blue](https://huggingface.co/spaces/notmax123/Blue) |
|
|
| > **End-user synthesis:** Use the ONNX model bundle **[`notmax123/blue-onnx`](https://huggingface.co/notmax123/blue-onnx)** with the BlueTTS README. This **`notmax123/blue`** repo supplies **training / finetuning weights** and files needed to **export new voice style JSON** for ONNX; it is not the ONNX runtime bundle. |
|
|
| ## Files |
|
|
| | File | Role | |
| |------|------| |
| | `blue_codec.safetensors` | Audio codec: mel ↔ latent, discrete/continuous conversion. | |
| | `stats_multilingual.pt` | Latent mean/std for normalization (same statistics as training). | |
| | `vf_estimator.safetensors` | Text-to-latent acoustic model (text encoder, reference encoder, flow-matching core). | |
| | `duration_predictor.safetensors` | Duration predictor checkpoint. | |
|
|
| ## Download |
|
|
| Repo id is **case-sensitive** — use `notmax123/blue` (not `Blue`). |
|
|
| ```bash |
| hf download notmax123/blue --repo-type model --local-dir ./pt_weights |
| ``` |
|
|
| Equivalent with the classic CLI: |
|
|
| ```bash |
| huggingface-cli download notmax123/blue --repo-type model --local-dir ./pt_weights |
| ``` |
|
|
| ## How to use |
|
|
| 1. **Training or finetuning:** Follow the [training](https://github.com/maxmelichov/BlueTTS/tree/main/training) directory in the BlueTTS GitHub repository. |
|
|
| 2. **New voices for ONNX inference:** Clone [BlueTTS](https://github.com/maxmelichov/BlueTTS), install with the `export` extra, download these weights locally, and run `scripts/export_new_voice.py` (see script docstring and project README). |
|
|
| ## License |
|
|
| MIT — see the [BlueTTS repository](https://github.com/maxmelichov/BlueTTS) for the full license text. |
|
|
