Merge pull request #154 from supertone-inc/readme-patch-1

Add RobustSpeechFlow paper citation to README
2026-05-22 14:05:12 +09:00 · 2026-05-22 11:15:09 +09:00 · 2026-05-21 11:25:13 +09:00 · 2026-05-21 10:01:45 +09:00 · 2026-05-20 18:52:45 +09:00 · 2026-05-20 03:52:46 +02:00
18 changed files with 161 additions and 57 deletions
--- a/README.md
+++ b/README.md
@@ -1,27 +1,54 @@
 # Supertonic — Lightning Fast, On-Device, Accurate TTS

-[![v3 Demo](https://img.shields.io/badge/🤗%20v3-Demo-yellow)](https://huggingface.co/spaces/Supertone/supertonic-3)
-[![v3 Models](https://img.shields.io/badge/🤗%20v3-Models-blue)](https://huggingface.co/Supertone/supertonic-3)
-[![v2 Branch](https://img.shields.io/badge/v2-release%2Fsupertonic--2-lightgrey)](https://github.com/supertone-inc/supertonic/tree/release/supertonic-2)
-[![v1 Demo](https://img.shields.io/badge/🤗%20v1%20(old)-Demo-lightgrey)](https://huggingface.co/spaces/Supertone/supertonic#interactive-demo)
-[![v1 Models](https://img.shields.io/badge/🤗%20v1%20(old)-Models-lightgrey)](https://huggingface.co/Supertone/supertonic)
-
 <p align="center">
  <img src="img/Supertonic3_HeroImage.png" alt="Supertonic 3 Banner">
 </p>

-**Supertonic** is a lightning-fast, on-device text-to-speech system designed for local inference with minimal overhead. Powered by ONNX Runtime, it runs entirely on your device—no cloud, no API calls, no privacy concerns.
+[![GitHub | Official Repo](https://img.shields.io/badge/GitHub-Official%20Repo-black?logo=github)](https://github.com/supertone-inc/supertonic)
+[![Models](https://img.shields.io/badge/🤗%20Hugging%20Face-Models-blue)](https://huggingface.co/Supertone/supertonic-3)
+[![Runs Locally via WebGPU](https://img.shields.io/badge/🤗%20Hugging%20Face-Demo-yellow)](https://huggingface.co/spaces/Supertone/supertonic-3)
+[![DemoPage | Audio Samples](https://img.shields.io/badge/DemoPage-Audio%20Samples-F5D90A?labelColor=0B0C0E)](https://supertonic3.github.io/)
+[![Voice Builder | Cloning Demo](https://img.shields.io/badge/Voice%20Builder-Cloning%20Demo-3457D5?logo=soundcloud&logoColor=white)](https://supertonic.supertone.ai/voice-builder)
+[![GitHub | Python Package](https://img.shields.io/badge/GitHub-Python%20Package-black?logo=github)](https://github.com/supertone-inc/supertonic-py)
+[![Docs | Python PyPI](https://img.shields.io/badge/Docs-Python%20PyPI-blue?logo=readthedocs&logoColor=white)](https://supertone-inc.github.io/supertonic-py/)
+
+<p align="center">
+  <a href="https://trendshift.io/repositories/15657" target="_blank"><img src="https://trendshift.io/api/badge/repositories/15657" alt="supertone-inc%2Fsupertonic | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+</p>
+
+**Supertonic** is a lightning-fast, on-device multilingual text-to-speech system designed for local inference with minimal overhead. Powered by ONNX Runtime, it runs entirely on your device—no cloud, no API calls, no privacy concerns.
+
+### ✨ Highlights
+
+- ⚡ **Blazingly Fast** — Low-latency, real-time synthesis across desktop, browser, mobile, and edge — fast enough to turn an entire webpage into audio in under a second
+- 🌍 **31-Language Multilingual** — Synthesize directly from text across 31 languages, or pass `lang="na"` to let Supertonic process the text language-agnostically when you don't know the input language — no separate language adapters needed
+- 🪶 **99M-Parameter Open-Weight Model** — A compact, fully open-weight checkpoint — a fraction of the size of 0.7B–2B class open TTS systems — for smaller downloads, faster cold starts, and lower memory footprint
+- 📱 **Edge-Device Ready** — Runs locally on desktop, mobile, browsers, and resource-constrained hardware like Raspberry Pi or e-readers, with zero network dependency, complete privacy, and no GPU required
+- 🔊 **44.1kHz High-Quality Audio** — Outputs studio-grade 44.1kHz 16-bit WAV directly, ready for production playback without any external upsampler
+- 🎭 **Expression Tags** — 10 inline tags (e.g. `<laugh>`, `<breath>`, `<sigh>`) bring natural human nuance into generated speech without prompt engineering or reference audio
+- 🛠️ **Multi-Runtime SDKs** — Ready-to-use examples through ONNX Runtime across Python, Node.js, Browser (WebGPU), Java, C++, C#, Go, Swift, iOS, Rust, and Flutter
+
+### 🌍 Supported Languages (31)
+
+Arabic (`ar`), Bulgarian (`bg`), Croatian (`hr`), Czech (`cs`), Danish (`da`), Dutch (`nl`), English (`en`), Estonian (`et`), Finnish (`fi`), French (`fr`), German (`de`), Greek (`el`), Hindi (`hi`), Hungarian (`hu`), Indonesian (`id`), Italian (`it`), Japanese (`ja`), Korean (`ko`), Latvian (`lv`), Lithuanian (`lt`), Polish (`pl`), Portuguese (`pt`), Romanian (`ro`), Russian (`ru`), Slovak (`sk`), Slovenian (`sl`), Spanish (`es`), Swedish (`sv`), Turkish (`tr`), Ukrainian (`uk`), Vietnamese (`vi`)
+
+> **Not sure which language your text is in?** Pass `lang="na"` and Supertonic will handle the input in a language-agnostic way — no explicit language tag required.

 ### 📰 Update News

+- **2026.05.20** - **Supertonic 3** is now officially supported in **[Supertone Play](https://play.supertone.ai/)** and the **[Supertone API](https://www.supertone.ai/ko/api)**. Visit Play or the API if you want a managed content creation workflow with diverse preset voices and zero-shot voice cloning.
+- **2026.05.18** - Python SDK v1.3.1 adds **`supertonic serve`**, a local HTTP server with native `/v1/tts` and OpenAI-compatible `/v1/audio/speech` endpoints. See the [serve documentation](https://supertone-inc.github.io/supertonic-py/cli/serve/).
+- **2026.05.18** - **[Voice Builder](https://supertonic.supertone.ai/voice-builder)** now supports **Supertonic 3**. Create a permanent custom voice profile for Supertonic and download version-specific JSON files for both Supertonic 2 and Supertonic 3. If you already created a Supertonic 2 voice, the matching Supertonic 3 JSON is now available from [My Page](https://supertonic.supertone.ai/my-page).
 - **2026.04.29** - 🎉 **Supertonic 3** released with **31-language support**, improved reading accuracy, fewer repeat/skip failures, and v2-compatible public ONNX assets. [Demo](https://huggingface.co/spaces/Supertone/supertonic-3) | [Models](https://huggingface.co/Supertone/supertonic-3)
- **2026.01.22** - **[Voice Builder](https://supertonic.supertone.ai/voice_builder)** is now live! Turn your voice into a deployable, edge-native TTS with permanent ownership.
+- **2026.01.22** - **[Voice Builder](https://supertonic.supertone.ai/voice-builder)** is now live! Turn your voice into a deployable, edge-native TTS with permanent ownership.
 - **2026.01.06** - 🎉 **Supertonic 2** released with 5-language support. The v2 code path is preserved on the [`release/supertonic-2`](https://github.com/supertone-inc/supertonic/tree/release/supertonic-2) branch.
 - **2025.12.10** - Added `supertonic` PyPI package! Install via `pip install supertonic`. For details, visit [supertonic-py documentation](https://supertone-inc.github.io/supertonic-py)
 - **2025.12.10** - Added [6 new voice styles](https://huggingface.co/Supertone/supertonic/tree/b10dbaf18b316159be75b34d24f740008fddd381) (M3, M4, M5, F3, F4, F5). See [Voices](https://supertone-inc.github.io/supertonic-py/voices/) for details
 - **2025.12.08** - Optimized ONNX models via [OnnxSlim](https://github.com/inisis/OnnxSlim) now available on [Hugging Face Models](https://huggingface.co/Supertone/supertonic)
 - **2025.11.24** - Added Flutter SDK support with macOS compatibility

+---
+
 ## Quick Start

 Install the Python SDK and generate speech immediately. On the first run, Supertonic downloads the model assets from Hugging Face automatically.
@@ -40,13 +67,36 @@ tts = TTS(auto_download=True)

 style = tts.get_voice_style(voice_name="M1")

-text = "A gentle breeze moved through the open window while everyone listened to the story."
-wav, duration = tts.synthesize(text, voice_style=style, lang="en")
+text = "Supertonic is a lightning fast, on-device TTS system."
+
+wav, duration = tts.synthesize(
+    text=text,
+    lang="en",                      # Language code (e.g., "en", "ko", "na" for language-agnostic)
+    voice_style=style,              # Voice style object
+    total_steps=8,                  # Quality: 5 (low) to 12 (high), default 8 (medium)
+    speed=1.05,                     # Speed: 0.7 (slow) to 2.0 (fast)
+)
+# wav: numpy array of shape (1, num_samples,) with dtype=np.float32, sampled at 44100 Hz
+# duration: numpy array of shape (1,) containing the duration of the generated audio in seconds

 tts.save_audio(wav, "output.wav")
-print(f"Generated {duration:.2f}s of audio")
+# import soundfile as sf
+# sf.write("output.wav", wav.squeeze(), 44100)
+
+print(f"Generated {duration[0]:.2f}s of audio")
 ```

+### Local HTTP Server
+
+The Python SDK can also run Supertonic as a local HTTP service. This is useful when you want to call Supertonic from tools that already speak HTTP, such as local agents, browser extensions, Electron apps, workflow automation tools, or OpenAI-compatible audio clients.
+
+```bash
+pip install 'supertonic[serve]'
+supertonic serve --host 127.0.0.1 --port 7788
+```
+
+Once running, use the native `POST /v1/tts` endpoint or the OpenAI-compatible `POST /v1/audio/speech` endpoint. The server also exposes interactive OpenAPI docs at `http://127.0.0.1:7788/docs`. See the [supertonic-py serve guide](https://supertone-inc.github.io/supertonic-py/cli/serve/) for request examples, batch synthesis, and custom Voice Builder JSON import.
+
 ## Getting Started

 First, clone the repository:
@@ -157,13 +207,14 @@ In Xcode: Targets → ExampleiOSApp → Signing: select your Team, then choose y

 </details>

+---

 ### Technical Details

 - **Runtime**: ONNX Runtime for cross-platform inference
 - **Browser Support**: onnxruntime-web for client-side inference
 - **Batch Processing**: Supports batch inference for improved throughput
- **Audio Output**: Outputs 16-bit WAV files
+- **Audio Output**: Outputs 44.1kHz 16-bit WAV files

 ## Performance Highlights

@@ -175,7 +226,40 @@ Supertonic 3 is designed for practical on-device inference: compact enough to ru
  <img src="img/metrics/s3_vs_measured_wer_range_voxcpm2.png" alt="Supertonic 3 reading accuracy compared with measured model ranges and VoxCPM2">
 </p>

-Across measured languages, Supertonic 3 stays within a competitive WER/CER range against much larger open TTS models such as VoxCPM2, while preserving a lightweight on-device deployment path. Asterisked languages use CER; the others use WER.
+Evaluated on the **[Minimax-MLS-test](https://huggingface.co/datasets/MiniMaxAI/TTS-MLS-Test) benchmark**, Supertonic 3 stays within a competitive WER/CER range against much larger open TTS models such as VoxCPM2, while preserving a lightweight on-device deployment path. Asterisked languages (`*`) use CER; the others use WER.
+
+<details>
+<summary><b>📊 Detailed per-language results (WER / CER*)</b></summary>
+
+<br>
+
+| Lang | VoxCPM2 | OmniVoice | Qwen3-TTS | Supertonic 2 | **Supertonic 3** |
+|---|:---:|:---:|:---:|:---:|:---:|
+| arabic\*   | 4.14  | 1.74  | —    | —    | **2.14**  |
+| czech      | 23.73 | 2.40  | —    | —    | **3.02**  |
+| dutch      | 0.84  | 0.77  | —    | —    | **1.47**  |
+| english    | 2.11  | 2.02  | 2.25 | 2.52 | **2.06**  |
+| finnish    | 2.29  | 3.94  | —    | —    | **5.40**  |
+| french     | 4.41  | 4.74  | 3.82 | 5.09 | **4.89**  |
+| german     | 0.85  | 0.96  | 0.52 | —    | **0.86**  |
+| greek      | 3.22  | 2.96  | —    | —    | **3.54**  |
+| hindi\*    | 5.85  | 5.14  | —    | —    | **5.34**  |
+| indonesian | 1.25  | 1.67  | —    | —    | **1.34**  |
+| italian    | 1.74  | 1.29  | 1.40 | —    | **1.75**  |
+| japanese\* | 3.35  | 3.81  | 3.67 | —    | **4.61**  |
+| korean\*   | 4.70  | 3.22  | 4.07 | 3.65 | **3.26**  |
+| polish     | 1.30  | 0.64  | —    | —    | **1.63**  |
+| portuguese | 1.74  | 1.40  | 1.21 | 1.52 | **2.48**  |
+| romanian   | 22.39 | 2.29  | —    | —    | **2.19**  |
+| russian    | 3.31  | 4.53  | 4.48 | —    | **3.99**  |
+| spanish    | 1.34  | 0.99  | 0.75 | 1.81 | **1.13**  |
+| turkish    | 0.88  | 2.18  | —    | —    | **1.00**  |
+| ukrainian  | 5.85  | 0.71  | —    | —    | **1.23**  |
+| vietnamese | 1.48  | 0.79  | —    | —    | **4.49**  |
+
+> Lower is better. `*` indicates CER (character error rate); all other rows use WER (word error rate). Dashes (`—`) indicate the model does not officially support the language or no result is available.
+
+</details>

 ### Supertonic 2 to Supertonic 3

@@ -201,6 +285,12 @@ Supertonic 3 runs fast on CPU, even compared with larger baselines measured on A

 At about 99M parameters across the public ONNX assets, Supertonic 3 is much smaller than 0.7B to 2B class open TTS systems. The smaller model size is a practical advantage for download size, startup time, and on-device inference.

+## Voice Cloning
+
+This open-weight repository focuses on fixed-voice, local TTS and does not include an official voice-cloning pipeline. If you want to bring your own voice to local Supertonic deployment, [Voice Builder](https://supertonic.supertone.ai/voice-builder) turns a short reference recording into version-specific JSON files for Supertonic 2 and Supertonic 3, so the same custom voice can move with you across supported Supertonic versions.
+
+For a managed creation workflow, **Supertonic 3 is now officially available in [Supertone Play](https://play.supertone.ai/) and the [Supertone API](https://www.supertone.ai/ko/api)**. Use them when you want hosted content creation tools, diverse commercially usable preset voices, zero-shot voice cloning, or API-based integration without managing local model files. You can also listen to Supertonic 3 zero-shot samples on the [official showcase](https://supertonic3.github.io/).
+
 ## Demo

 > **Try it now**: Experience Supertonic in your browser with our [**Interactive Demo**](https://huggingface.co/spaces/Supertone/supertonic-3), or get started with pre-trained models from [**Hugging Face Hub**](https://huggingface.co/Supertone/supertonic-3)
@@ -223,29 +313,7 @@ Turns any webpage into audio in under one second, delivering lightning-fast, on-

 https://github.com/user-attachments/assets/cc8a45fc-5c3e-4b2c-8439-a14c3d00d91c

-## Why Supertonic?
-
- **Blazingly Fast**: Optimized for low-latency, on-device speech generation across desktop, browser, and edge deployments
- **Lightweight**: Compact ONNX assets designed for efficient local execution
- **On-Device Capable**: Complete privacy and zero network dependency
- **Accurate Reading**: Improved reading stability with fewer repeat and skip failures
- **Expressive Tags**: Supports simple expression tags such as `<laugh>`, `<breath>`, and `<sigh>`
- **Flexible Deployment**: Ready-to-use examples across Python, JavaScript, browser, mobile, and native runtimes
-
-## Language Support
-
-Supertonic 3 supports 31 languages:
-
-| Code | Language | Code | Language | Code | Language | Code | Language |
-|------|----------|------|----------|------|----------|------|----------|
-| `en` | English | `ko` | Korean | `ja` | Japanese | `ar` | Arabic |
-| `bg` | Bulgarian | `cs` | Czech | `da` | Danish | `de` | German |
-| `el` | Greek | `es` | Spanish | `et` | Estonian | `fi` | Finnish |
-| `fr` | French | `hi` | Hindi | `hr` | Croatian | `hu` | Hungarian |
-| `id` | Indonesian | `it` | Italian | `lt` | Lithuanian | `lv` | Latvian |
-| `nl` | Dutch | `pl` | Polish | `pt` | Portuguese | `ro` | Romanian |
-| `ru` | Russian | `sk` | Slovak | `sl` | Slovenian | `sv` | Swedish |
-| `tr` | Turkish | `uk` | Ukrainian | `vi` | Vietnamese | | |
+## Programming Language Support

 We provide ready-to-use TTS inference examples across multiple ecosystems:

@@ -368,11 +436,25 @@ Supertonic is designed to handle complex, real-world text inputs that contain na
 | **VoiceChat** | On-device voice-to-voice LLM chatbot in the browser | [Demo](https://huggingface.co/spaces/RickRossTN/ai-voice-chat) · [GitHub](https://github.com/irelate-ai/voice-chat) |
 | **OmniAvatar** | Talking avatar video generator from photo + speech | [Demo](https://huggingface.co/spaces/alexnasa/OmniAvatar) |
 | **CopiloTTS** | Kotlin Multiplatform TTS SDK via ONNX Runtime | [GitHub](https://github.com/sigmadeltasoftware/CopiloTTS) |
+| **Aftertone** | Local post-reply TTS for Cursor & Claude Code (Supertonic 3 ONNX, on-device daemon) | [GitHub](https://github.com/omarelkhal/aftertone) · [Demo](https://github.com/omarelkhal/aftertone/releases/download/demo-asset/demo.mp4) |
 | **Voice Mixer** | PyQt5 tool for mixing and modifying voice styles | [GitHub](https://github.com/Topping1/Supertonic-Voice-Mixer) |
 | **Supertonic MNN** | Lightweight library based on MNN (fp32/fp16/int8) | [GitHub](https://github.com/vra/supertonic-mnn) · [PyPI](https://pypi.org/project/supertonic-mnn/) |
 | **Transformers.js** | Hugging Face's JS library with Supertonic support | [GitHub PR](https://github.com/huggingface/transformers.js/pull/1459) · [Demo](https://huggingface.co/spaces/webml-community/Supertonic-TTS-WebGPU) |
 | **Pinokio** | 1-click localhost cloud for Mac, Windows, and Linux | [Pinokio](https://pinokio.co/) · [GitHub](https://github.com/SUP3RMASS1VE/SuperTonic-TTS) |

+## Models & Versions
+
+|  | **Supertonic 3** | Supertonic 2 | Supertonic 1 |
+|---|:---:|:---:|:---:|
+| **Status** | 🟢 Latest | Stable | Legacy |
+| **Parameters** | ~99M | ~66M | ~66M |
+| **Languages** | 31 | 5 | 1 (en) |
+| **Expression Tags** | ✅ 10 tags | — | — |
+| **Code** | [main](https://github.com/supertone-inc/supertonic) | [release/supertonic-2](https://github.com/supertone-inc/supertonic/tree/release/supertonic-2) | — |
+| **Weights** | [🤗 HF](https://huggingface.co/Supertone/supertonic-3) | [🤗 HF](https://huggingface.co/Supertone/supertonic-2) | [🤗 HF](https://huggingface.co/Supertone/supertonic) |
+| **Interactive Demo** | [🤗 Space](https://huggingface.co/spaces/Supertone/supertonic-3) | [🤗 Space](https://huggingface.co/spaces/Supertone/supertonic-2) | [🤗 Space](https://huggingface.co/spaces/Supertone/supertonic#interactive-demo) |
+| **Audio Samples** | [DemoPage](https://supertonic3.github.io/) | — | [DemoPage](https://supertonictts.github.io/) |
+
 ## Citation

 The following papers describe the core technologies used in Supertonic. If you use this system in your research or find these techniques useful, please consider citing the relevant papers:
@@ -419,6 +501,22 @@ This paper describes the self-purification technique for training flow matching
 }
 ```

+### RobustSpeechFlow: Learning Robust Text-to-Speech Trajectories via Augmentation-based Contrastive Flow Matching
+
+This paper describes the RobustSpeechFlow technique for improving the robustness and quality of text-to-speech generation by optimizing flow-matching trajectories against data variability
+
+```bibtex
+@misc{yang2026robustspeechflowlearningrobusttexttospeech,
+      title={RobustSpeechFlow: Learning Robust Text-to-Speech Trajectories via Augmentation-based Contrastive Flow Matching}, 
+      author={Jinhyeok Yang and Hyeongju Kim and Yechan Yu and Joon Byun and Frederik Bous and Juheon Lee},
+      year={2026},
+      eprint={2605.22083},
+      archivePrefix={arXiv},
+      primaryClass={cs.SD},
+      url={https://arxiv.org/abs/2605.22083}, 
+}
+```
+
 ## License

 This project's sample code is released under the MIT License. - see the [LICENSE](https://github.com/supertone-inc/supertonic?tab=MIT-1-ov-file) for details.
--- a/cpp/helper.cpp
+++ b/cpp/helper.cpp
@@ -12,7 +12,7 @@
 using json = nlohmann::json;

 // Available languages for multilingual TTS
-const std::vector<std::string> AVAILABLE_LANGS = {"en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi"};
+const std::vector<std::string> AVAILABLE_LANGS = {"en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na"};

 // Global tensor buffers for memory management
 static std::vector<std::vector<float>> g_tensor_buffers_float;
--- a/csharp/Helper.cs
+++ b/csharp/Helper.cs
@@ -13,7 +13,7 @@ namespace Supertonic
    // Available languages for multilingual TTS
    public static class Languages
    {
-        public static readonly string[] Available = { "en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi" };
+        public static readonly string[] Available = { "en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na" };
    }

    // ============================================================================
--- a/flutter/lib/helper.dart
+++ b/flutter/lib/helper.dart
@@ -12,7 +12,7 @@ final logger = Logger(
 );

 // Available languages for multilingual TTS
-const List<String> availableLangs = ['en', 'ko', 'ja', 'ar', 'bg', 'cs', 'da', 'de', 'el', 'es', 'et', 'fi', 'fr', 'hi', 'hr', 'hu', 'id', 'it', 'lt', 'lv', 'nl', 'pl', 'pt', 'ro', 'ru', 'sk', 'sl', 'sv', 'tr', 'uk', 'vi'];
+const List<String> availableLangs = ['en', 'ko', 'ja', 'ar', 'bg', 'cs', 'da', 'de', 'el', 'es', 'et', 'fi', 'fr', 'hi', 'hr', 'hu', 'id', 'it', 'lt', 'lv', 'nl', 'pl', 'pt', 'ro', 'ru', 'sk', 'sl', 'sv', 'tr', 'uk', 'vi', 'na'];

 bool isValidLang(String lang) => availableLangs.contains(lang);

--- a/go/README.md
+++ b/go/README.md
@@ -138,6 +138,7 @@ This will:
 | `-use-gpu` | flag | false | Use GPU for inference (default: CPU) |
 | `-onnx-dir` | str | `../assets/onnx` | Path to ONNX model directory |
 | `-total-step` | int | 8 | Number of denoising steps (higher = better quality, slower) |
+| `-speed` | float | 1.05 | Speech speed factor (higher = faster, lower = slower) |
 | `-n-test` | int | 4 | Number of times to generate each sample |
 | `-voice-style` | str | `../assets/voice_styles/M1.json` | Voice style file path(s), comma-separated |
 | `-text` | str | (long default text) | Text(s) to synthesize, pipe-separated |
--- a/go/helper.go
+++ b/go/helper.go
@@ -19,7 +19,7 @@ import (
 )

 // Available languages for multilingual TTS
-var AvailableLangs = []string{"en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi"}
+var AvailableLangs = []string{"en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na"}

 // Config structures
 type SpecProcessorConfig struct {
--- a/ios/ExampleiOSApp/TTSService.swift
+++ b/ios/ExampleiOSApp/TTSService.swift
@@ -35,6 +35,7 @@ final class TTSService {
        case tr = "tr"
        case uk = "uk"
        case vi = "vi"
+        case na = "na"

        var displayName: String {
            switch self {
@@ -69,6 +70,7 @@ final class TTSService {
            case .tr: return "Turkish"
            case .uk: return "Ukrainian"
            case .vi: return "Vietnamese"
+            case .na: return "Auto (language-agnostic)"
            }
        }
    }
--- a/java/Helper.java
+++ b/java/Helper.java
@@ -22,7 +22,7 @@ import java.util.regex.Matcher;
 * Available languages for multilingual TTS
 */
 class Languages {
-    public static final List<String> AVAILABLE = Arrays.asList("en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi");
+    public static final List<String> AVAILABLE = Arrays.asList("en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na");
    
    public static boolean isValid(String lang) {
        return AVAILABLE.contains(lang);
--- a/java/README.md
+++ b/java/README.md
@@ -120,6 +120,7 @@ java -jar target/tts-example.jar --total-step 10 --text "Your custom text here"
 | `--use-gpu` | flag | False | Use GPU for inference (default: CPU) |
 | `--onnx-dir` | str | `../assets/onnx` | Path to ONNX model directory |
 | `--total-step` | int | 8 | Number of denoising steps (higher = better quality, slower) |
+| `--speed` | float | 1.05 | Speech speed factor (higher = faster, lower = slower) |
 | `--n-test` | int | 4 | Number of times to generate each sample |
 | `--voice-style` | str+ | `../assets/voice_styles/M1.json` | Voice style file path(s), comma-separated |
 | `--text` | str+ | (long default text) | Text(s) to synthesize, pipe-separated |
--- a/nodejs/helper.js
+++ b/nodejs/helper.js
@@ -5,7 +5,7 @@ import * as ort from 'onnxruntime-node';

 const __filename = fileURLToPath(import.meta.url);

-const AVAILABLE_LANGS = ["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi"];
+const AVAILABLE_LANGS = ["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na"];

 /**
 * Unicode text processor
--- a/py/example_pypi.py
+++ b/py/example_pypi.py
@@ -14,3 +14,4 @@ wav, duration = tts.synthesize(text, voice_style=style)

 # Save to file
 tts.save_audio(wav, "results/example_pypi.wav")
+print(f"Generated {duration[0]:.2f}s of audio")
--- a/py/helper.py
+++ b/py/helper.py
@@ -10,7 +10,7 @@ import onnxruntime as ort

 import re

-AVAILABLE_LANGS = ["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi"]
+AVAILABLE_LANGS = ["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na"]


 class UnicodeProcessor:
--- a/py/uv.lock
+++ b/py/uv.lock
@@ -705,17 +705,16 @@ wheels = [

 [[package]]
 name = "protobuf"
-version = "6.33.5"
+version = "6.32.1"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/ba/25/7c72c307aafc96fa87062aa6291d9f7c94836e43214d43722e86037aac02/protobuf-6.33.5.tar.gz", hash = "sha256:6ddcac2a081f8b7b9642c09406bc6a4290128fce5f471cddd165960bb9119e5c", size = 444465, upload-time = "2026-01-29T21:51:33.494Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/fa/a4/cc17347aa2897568beece2e674674359f911d6fe21b0b8d6268cd42727ac/protobuf-6.32.1.tar.gz", hash = "sha256:ee2469e4a021474ab9baafea6cd070e5bf27c7d29433504ddea1a4ee5850f68d", size = 440635, upload-time = "2025-09-11T21:38:42.935Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b1/79/af92d0a8369732b027e6d6084251dd8e782c685c72da161bd4a2e00fbabb/protobuf-6.33.5-cp310-abi3-win32.whl", hash = "sha256:d71b040839446bac0f4d162e758bea99c8251161dae9d0983a3b88dee345153b", size = 425769, upload-time = "2026-01-29T21:51:21.751Z" },
-    { url = "https://files.pythonhosted.org/packages/55/75/bb9bc917d10e9ee13dee8607eb9ab963b7cf8be607c46e7862c748aa2af7/protobuf-6.33.5-cp310-abi3-win_amd64.whl", hash = "sha256:3093804752167bcab3998bec9f1048baae6e29505adaf1afd14a37bddede533c", size = 437118, upload-time = "2026-01-29T21:51:24.022Z" },
-    { url = "https://files.pythonhosted.org/packages/a2/6b/e48dfc1191bc5b52950246275bf4089773e91cb5ba3592621723cdddca62/protobuf-6.33.5-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:a5cb85982d95d906df1e2210e58f8e4f1e3cdc088e52c921a041f9c9a0386de5", size = 427766, upload-time = "2026-01-29T21:51:25.413Z" },
-    { url = "https://files.pythonhosted.org/packages/4e/b1/c79468184310de09d75095ed1314b839eb2f72df71097db9d1404a1b2717/protobuf-6.33.5-cp39-abi3-manylinux2014_aarch64.whl", hash = "sha256:9b71e0281f36f179d00cbcb119cb19dec4d14a81393e5ea220f64b286173e190", size = 324638, upload-time = "2026-01-29T21:51:26.423Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/f5/65d838092fd01c44d16037953fd4c2cc851e783de9b8f02b27ec4ffd906f/protobuf-6.33.5-cp39-abi3-manylinux2014_s390x.whl", hash = "sha256:8afa18e1d6d20af15b417e728e9f60f3aa108ee76f23c3b2c07a2c3b546d3afd", size = 339411, upload-time = "2026-01-29T21:51:27.446Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/53/a9443aa3ca9ba8724fdfa02dd1887c1bcd8e89556b715cfbacca6b63dbec/protobuf-6.33.5-cp39-abi3-manylinux2014_x86_64.whl", hash = "sha256:cbf16ba3350fb7b889fca858fb215967792dc125b35c7976ca4818bee3521cf0", size = 323465, upload-time = "2026-01-29T21:51:28.925Z" },
-    { url = "https://files.pythonhosted.org/packages/57/bf/2086963c69bdac3d7cff1cc7ff79b8ce5ea0bec6797a017e1be338a46248/protobuf-6.33.5-py3-none-any.whl", hash = "sha256:69915a973dd0f60f31a08b8318b73eab2bd6a392c79184b3612226b0a3f8ec02", size = 170687, upload-time = "2026-01-29T21:51:32.557Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/98/645183ea03ab3995d29086b8bf4f7562ebd3d10c9a4b14ee3f20d47cfe50/protobuf-6.32.1-cp310-abi3-win32.whl", hash = "sha256:a8a32a84bc9f2aad712041b8b366190f71dde248926da517bde9e832e4412085", size = 424411, upload-time = "2025-09-11T21:38:27.427Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/f3/6f58f841f6ebafe076cebeae33fc336e900619d34b1c93e4b5c97a81fdfa/protobuf-6.32.1-cp310-abi3-win_amd64.whl", hash = "sha256:b00a7d8c25fa471f16bc8153d0e53d6c9e827f0953f3c09aaa4331c718cae5e1", size = 435738, upload-time = "2025-09-11T21:38:30.959Z" },
+    { url = "https://files.pythonhosted.org/packages/10/56/a8a3f4e7190837139e68c7002ec749190a163af3e330f65d90309145a210/protobuf-6.32.1-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:d8c7e6eb619ffdf105ee4ab76af5a68b60a9d0f66da3ea12d1640e6d8dab7281", size = 426454, upload-time = "2025-09-11T21:38:34.076Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/be/8dd0a927c559b37d7a6c8ab79034fd167dcc1f851595f2e641ad62be8643/protobuf-6.32.1-cp39-abi3-manylinux2014_aarch64.whl", hash = "sha256:2f5b80a49e1eb7b86d85fcd23fe92df154b9730a725c3b38c4e43b9d77018bf4", size = 322874, upload-time = "2025-09-11T21:38:35.509Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/f6/88d77011b605ef979aace37b7703e4eefad066f7e84d935e5a696515c2dd/protobuf-6.32.1-cp39-abi3-manylinux2014_x86_64.whl", hash = "sha256:b1864818300c297265c83a4982fd3169f97122c299f56a56e2445c3698d34710", size = 322013, upload-time = "2025-09-11T21:38:37.017Z" },
+    { url = "https://files.pythonhosted.org/packages/97/b7/15cc7d93443d6c6a84626ae3258a91f4c6ac8c0edd5df35ea7658f71b79c/protobuf-6.32.1-py3-none-any.whl", hash = "sha256:2601b779fc7d32a866c6b4404f9d42a3f67c5b9f3f15b4db3cccabe06b95c346", size = 169289, upload-time = "2025-09-11T21:38:41.234Z" },
 ]

 [[package]]
--- a/rust/README.md
+++ b/rust/README.md
@@ -127,6 +127,7 @@ This will:
 | `--use-gpu` | flag | False | Use GPU for inference (default: CPU) |
 | `--onnx-dir` | str | `../assets/onnx` | Path to ONNX model directory |
 | `--total-step` | int | 8 | Number of denoising steps (higher = better quality, slower) |
+| `--speed` | float | 1.05 | Speech speed factor (higher = faster, lower = slower) |
 | `--n-test` | int | 4 | Number of times to generate each sample |
 | `--voice-style` | str+ | `../assets/voice_styles/M1.json` | Voice style file path(s), comma-separated |
 | `--text` | str+ | (long default text) | Text(s) to synthesize, pipe-separated |
--- a/rust/src/helper.rs
+++ b/rust/src/helper.rs
@@ -15,7 +15,7 @@ use rand_distr::{Distribution, Normal};
 use regex::Regex;

 // Available languages for multilingual TTS
-pub const AVAILABLE_LANGS: &[&str] = &["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi"];
+pub const AVAILABLE_LANGS: &[&str] = &["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na"];

 pub fn is_valid_lang(lang: &str) -> bool {
    AVAILABLE_LANGS.contains(&lang)
--- a/swift/README.md
+++ b/swift/README.md
@@ -97,6 +97,7 @@ This will:
 | `--use-gpu` | flag | False | Use GPU for inference (default: CPU) |
 | `--onnx-dir` | str | `../assets/onnx` | Path to ONNX model directory |
 | `--total-step` | int | 8 | Number of denoising steps (higher = better quality, slower) |
+| `--speed` | float | 1.05 | Speech speed factor (higher = faster, lower = slower) |
 | `--n-test` | int | 4 | Number of times to generate each sample |
 | `--voice-style` | str+ | `../assets/voice_styles/M1.json` | Voice style file path(s) |
 | `--text` | str+ | (long default text) | Text(s) to synthesize |
--- a/swift/Sources/Helper.swift
+++ b/swift/Sources/Helper.swift
@@ -4,7 +4,7 @@ import OnnxRuntimeBindings

 // MARK: - Available Languages

-let AVAILABLE_LANGS = ["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi"]
+let AVAILABLE_LANGS = ["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi", "na"]

 func isValidLang(_ lang: String) -> Bool {
    return AVAILABLE_LANGS.contains(lang)
--- a/web/helper.js
+++ b/web/helper.js
@@ -1,7 +1,7 @@
 import * as ort from 'onnxruntime-web';

 // Available languages for multilingual TTS
-export const AVAILABLE_LANGS = ['en', 'ko', 'ja', 'ar', 'bg', 'cs', 'da', 'de', 'el', 'es', 'et', 'fi', 'fr', 'hi', 'hr', 'hu', 'id', 'it', 'lt', 'lv', 'nl', 'pl', 'pt', 'ro', 'ru', 'sk', 'sl', 'sv', 'tr', 'uk', 'vi'];
+export const AVAILABLE_LANGS = ['en', 'ko', 'ja', 'ar', 'bg', 'cs', 'da', 'de', 'el', 'es', 'et', 'fi', 'fr', 'hi', 'hr', 'hu', 'id', 'it', 'lt', 'lv', 'nl', 'pl', 'pt', 'ro', 'ru', 'sk', 'sl', 'sv', 'tr', 'uk', 'vi', 'na'];

 export function isValidLang(lang) {
    return AVAILABLE_LANGS.includes(lang);
Author	SHA1	Message	Date
Jinhyeok Yang	dff55dc000	Merge pull request #154 from supertone-inc/readme-patch-1 Add RobustSpeechFlow paper citation to README	2026-05-22 14:05:12 +09:00
Jinhyeok Yang	4ae3de90e7	Add RobustSpeechFlow paper citation to README Added a new section for the RobustSpeechFlow paper, including a summary and citation.	2026-05-22 11:15:09 +09:00
Yechan Yu	13535a7090	Merge pull request #149 from omarelkhal/docs/add-aftertone-built-with docs: add Aftertone to Built with Supertonic	2026-05-21 11:25:13 +09:00
Yechan Yu	4a687ea7ea	Merge pull request #143 from NgoQuocViet2001/ai/trending-readme-speed-arg docs(readme): document `--speed` flag in Go/Rust/Java/Swift args tables	2026-05-21 10:01:45 +09:00
haeon	2b54f70a27	docs: mention Supertonic 3 managed services	2026-05-20 18:52:45 +09:00
Omar El Khal	f8270b660a	docs: add Aftertone to Built with Supertonic Aftertone is a separate MIT project that runs local post-reply TTS for coding agents using Supertonic 3 ONNX weights from Hugging Face. Co-authored-by: Cursor <cursoragent@cursor.com>	2026-05-20 03:52:46 +02:00
NgoQuocViet2001	83e9881f31	docs(readme): document --speed flag in Go/Rust/Java/Swift args tables The --speed parameter was announced in each language README's "Update News" entry dated 2025.11.19 and is already parsed by the example code in every language ({go,rust,java,swift}/example_onnx.*), but the "Available Arguments" reference table is missing the row in 4 of the 8 language READMEs. The Python, Node.js, C#, and C++ READMEs already list it. Add the missing row in each affected table, verbatim with the wording already used in the other 4 READMEs: \| --speed \| float \| 1.05 \| Speech speed factor (higher = faster, lower = slower) \| Go uses single-dash to match the surrounding rows in its own table.	2026-05-19 10:13:29 +07:00
haeon	67175af735	docs: mention Python HTTP server	2026-05-18 19:08:46 +09:00
haeon	98a301fc62	Update README for Supertonic 3 Voice Builder	2026-05-18 15:22:56 +09:00
Juheon	5379cc4e42	Merge pull request #114 from fbdp1202/docs/update-readme-supertonic-3 docs: revamp README for Supertonic 3	2026-05-16 18:24:10 +09:00
fbdp1202	26c1f17ee1	docs: annotate Quick Start with wav/duration shapes and soundfile alternative Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-15 23:35:33 +09:00
fbdp1202	912c54b435	fix: Supertonic 3 compatibility across all language examples - README Quick Start: format `duration[0]` instead of the ndarray itself (numpy refuses `f"{ndarray:.2f}"`; matches official `dur[0]:.2f` pattern) - py/example_pypi.py: print synthesized duration to mirror the docstring example - Add `"na"` to AVAILABLE_LANGS / Languages.Available / availableLangs across all 11 runtimes (Python/Node/Web/Java/C++/C#/Go/Swift/Rust/Flutter/iOS) so the language-agnostic fallback advertised in the README actually passes per-runtime lang validation before being sent to the v3 ONNX duration predictor Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-15 23:22:42 +09:00
Yechan Yu	f8bd509733	Fix Docs url	2026-05-15 19:38:32 +09:00
fbdp1202	12cd844e2c	docs: revamp README for Supertonic 3 - Move shields.io badges below banner, keep only latest v3 set - Add Trendshift badge (centered) - Add ✨ Highlights section absorbing former "Why Supertonic?" content - List 31 supported languages with `lang="na"` note for unknown-language input - Rename runtime examples section to "Programming Language Support" - Add Minimax-MLS-test detailed WER/CER table (collapsible) with VoxCPM2, OmniVoice, Qwen3-TTS, Supertonic 2/3; mark ar/hi/ja/ko as CER - Add "Models & Versions" comparison table covering v1/v2/v3 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-15 18:25:37 +09:00