Repo brief: supertone-inc/supertonic

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T14:25:04.281Z · commit 0a98c9f127ac

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 3d ago
• 4 active contributors
• MIT licensed
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Supertonic is a production-grade, on-device multilingual text-to-speech (TTS) engine powered by ONNX Runtime, supporting 31 languages with native inference on edge devices. It eliminates cloud dependency by running entirely locally via optimized ONNX models, enabling low-latency speech synthesis with minimal resource overhead—currently at v3 with improved accuracy and reduced synthesis failures compared to v2. Multi-SDK monorepo: language-specific implementations in top-level directories (cpp/, csharp/, flutter/ for Dart, go/, python/, rust/, js/). Each contains example_ONNX.* reference implementations, Helper.* utility wrappers, and language-native bindings. Flutter…

Start here

Open these first:

• py/example_onnx.py — Primary Python entry point demonstrating ONNX Runtime TTS inference workflow; essential for understanding the core TTS…
• go/example_onnx.go — Go implementation showing ONNX session management and audio processing; defines the reference inference pattern across…
• cpp/example_onnx.cpp — C++ example with lowest-level ONNX Runtime integration; critical for performance-sensitive implementations
• py/helper.py — Shared utilities for text preprocessing, audio encoding/decoding, and model loading; foundational for all Python…
• go/helper.go — Go utility functions for WAV file I/O, DSP processing, and ONNX session initialization; mirrors Python helper pattern

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

# Clone the repository
git clone https://github.com/supertone-inc/supertonic.git
cd supertonic

# Python (recommended entry point)
pip install supertonic
python -c "from supertonic import TTS; tts = TTS(auto_download=True); print('Ready')"

# Or C++ example
cd cpp && mkdir build && cd build && cmake .. && make && ./example_onnx

# Or Flutter/Dart
cd flutter && flutter pub get && flutter run -d macos

Daily commands:

Python: python -c 'from supertonic import TTS; tts = TTS(); wav, dur = tts.synthesize("Hello", voice_style=tts.get_voice_style("M1"), lang="en"); tts.save_audio(wav, "out.wav")'. C++: `cd cpp && cmake . && mak…

…shortened for this brief.

Key cautions & unknowns

• Small team — 4 contributors active in recent commits
• Single-maintainer risk — top contributor 81% of recent commits
• Model auto-download: TTS(auto_download=True) downloads ~100s of MB from HuggingFace on first instantiation—no progress bar, network errors fatal. Language parity: Not all 31 languages available in all SDKs…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.