On-device SDKs
KittenTTS SDKs run speech synthesis locally with ONNX. After model assets are available, text does not need to leave the device for generation.
| SDK | Best for | Current package | Start |
|---|---|---|---|
| Python | Scripts, services, notebooks, CPU or CUDA inference | GitHub wheel 0.8.1 | Python SDK |
| React Native | iOS, Android, Expo development builds, React Native Web | npm @kittentts/react-native 1.2.0 | React Native SDK |
| Swift | Native iOS and macOS apps | Swift Package 0.1.0 | Swift SDK |
| Flutter | Mobile, desktop, and Flutter Web from one Dart codebase | pub.dev kittentts 0.1.1 | Flutter SDK |
| Web and Node.js | Browser, Vite, React, Node services, custom storage | Source preview | Web SDK |
The SDKs are evolving. Pin a release or commit and test model downloads, offline startup, and audio playback in the exact environment you ship.
Pick by requirement
| Requirement | Recommended starting point |
|---|---|
| Python batch or server generation | Python installation |
| Expo or bare React Native | React Native setup |
| Native SwiftUI or AppKit/UIKit | Swift installation |
| One Flutter codebase across mobile, desktop, and web | Flutter installation |
| Browser-only, Vite, React, Electron, or Node | Web and Node setup |
| No first-run network download | SDK-specific offline-assets guide |
| Hosted inference with an API key | Public API quickstart |
Shared model layer
- Nano, Nano int8, Micro, and Mini model choices.
- Bella, Jasper, Luna, Bruno, Rosie, Hugo, Kiki, and Leo voices.
- 24 kHz audio output.
- Adjustable speech speed.
- Local model download and caching.
- Text normalization and CE-compatible phonemization.
The higher-level SDK surface intentionally differs by runtime. React Native, Swift, Flutter, and Web expose word timings and local streaming. Swift includes native playback. React Native and Flutter use adapters so an app can keep its existing audio stack. Web supports WAV and MP3 encoding plus pluggable asset storage. Python stays close to NumPy and SoundFile.
Hosted API or SDK?
Use the hosted API when your server should own inference and deployment. Use an SDK when offline operation, local privacy, or avoiding a network round trip matters more than the first-run model download and device integration work.
Source of truth
These guides are based on the current public APIs, examples, package manifests, and source in the KittenML GitHub organization. Pin a release or commit in production: every SDK is still marked as a developer preview and surfaces can change.