| license: other | |
| license_name: openrail-m | |
| license_link: https://huggingface.co/Supertone/supertonic | |
| base_model: Supertone/supertonic | |
| tags: | |
| - text-to-speech | |
| - coreml | |
| - onnx | |
| - supertone | |
| language: | |
| - en | |
| # Supertonic Core ML (fp16) — on-device iOS companion | |
| This Hugging Face **model** repository is maintained for **on-device iOS** integration around [Supertone/supertonic](https://huggingface.co/Supertone/supertonic) (OpenRAIL-M). | |
| ## What is published here | |
| | Path | Contents | | |
| |------|-----------| | |
| | `scripts/` | `convert_supertonic_coreml.py`, `run_mac_tts.py`, `requirements-export.txt` — download Hub ONNX + configs + voice styles; run TTS on macOS with **ONNX Runtime + Core ML Execution Provider**. | | |
| | `coreml_fp16/` | **Placeholder for native Core ML `mlprogram` / `.mlpackage` bundles (fp16 storage).** This mirror does not currently ship converted graphs here: `coremltools` does not support a reliable ONNX→`mlprogram` path for these networks (legacy converters fail on ops such as LayerNorm). When/if native bundles exist, they should be placed under this directory with a short `MANIFEST.json` (see `scripts/` comments). | | |
| ## Recommended runtime (today) | |
| - **Weights:** use upstream **[Supertone/supertonic](https://huggingface.co/Supertone/supertonic)** `onnx/*.onnx` + `onnx/tts.json` + `onnx/unicode_indexer.json` + `voice_styles/*.json`. | |
| - **Apple acceleration:** load ONNX with **ONNX Runtime** and enable the **Core ML execution provider** (same approach as typical on-device iOS clients). | |
| ## License | |
| - **Base model & voice styles:** follow [Supertone/supertonic](https://huggingface.co/Supertone/supertonic) (OpenRAIL-M) and Supertone’s terms. | |
| - **Scripts in `scripts/`:** follow the license noted in those script files where copied from a local project. | |
| ## Disclaimer | |
| This repo is **not** affiliated with Supertone Inc. It exists to document and distribute **companion tooling** and a reserved layout for optional Core ML artifacts. Do not imply official endorsement by Supertone. | |