Skip to main content

​
Overview

SupertonicTTSService is a Pipecat-compatible TTSService wrapper for the official Supertonic Python SDK. It runs the Supertonic model locally and outputs TTSAudioRawFrame audio. The package is an independent community integration and is not affiliated with Supertone or the Supertonic team.

Source Repository

Source code, examples, and issues for the Supertonic integration

PyPI Package

The pipecat-supertonic package on PyPI

Supertonic

The official Supertonic SDK and model

​
Installation

This is a community-maintained package distributed separately from pipecat-ai:

​
Prerequisites

Supertonic runs locally; no account or API key is required. By default the service downloads and caches the Supertonic model on first use (controlled by the auto_download parameter). Call warmup() during application startup before the service is used in a live Pipecat pipeline. The service does not lazy-load Supertonic during active TTS requests and fails fast if used before warmup, which avoids first-request cold-start delays and keeps TTS frame ordering stable.

​
Configuration

​
str
default:"supertonic-3"
Supertonic model name.
​
str
default:"M1"
Supertonic voice name. Supported voices: F1, F2, F3, F4, F5, M1, M2, M3, M4, M5.
​
Language | str
default:"Language.EN"
Language for synthesis.
​
float
default:"1.05"
Speech speed multiplier.
​
int
default:"5"
Number of synthesis steps.
​
int
default:"None"
Maximum characters per synthesized chunk.
​
float
default:"0.3"
Silence inserted between synthesized chunks.
​
bool
default:"True"
Whether to download model assets automatically.
​
int
default:"None"
ONNX intra-op thread count.
​
int
default:"None"
ONNX inter-op thread count.
​
int
default:"None"
Output sample rate for generated audio.
​
SupertonicTTSService.Settings
default:"None"
Runtime-configurable settings. When provided alongside direct parameters, settings values take precedence. See Settings below.

​
Settings

Runtime-configurable settings passed via the settings constructor argument using SupertonicTTSService.Settings(...).
The Settings dataclass extends Pipecat’s TTSSettings. See the source repository for the authoritative, up-to-date list.

​
Usage

​
Compatibility

Tested with pipecat-ai==1.2.0 and supertonic==1.2.1. Check the source repository for the latest tested version and changelog.