Skip to main content
Deepgram's Docs

Search documentation

Type to search this documentation.

On this pageOverview

Validate Deepgram Self-Hosted TTS

tts-tui is an open-source terminal application written in Rust for testing and validating Deepgram text-to-speech on self-hosted deployments. It supports Deepgram-compatible HTTP endpoints and Amazon SageMaker, with interactive voice selection, multi-format audio output, and local audio caching.

  • Validate self-hosted TTS — confirm that Aura-2 models produce correct audio on your own infrastructure before going to production.
  • Test output formats — switch between MP3, Linear16 (WAV), FLAC, and other encodings with configurable sample rates.
  • Multi-language support — synthesize speech in any Deepgram-supported language and save utterances for comparison.
  • Audio caching — repeated playback is served from disk instantly, so you can iterate without redundant API calls.
  • Dual provider support — test both Deepgram-compatible HTTP endpoints and Amazon SageMaker InvokeEndpoint deployments from the same tool.
  • Rust Toolchain (only required when building from source)
  • Deepgram self-hosted TTS deployment
  1. Download the latest release from GitHub Releases.
  2. Extract the ZIP file.
  3. Run the tts-tui binary.
Bash
git clone https://github.com/deepgram-devs/deepgram-demos-rust.git
cd deepgram-demos-rust/tts-tui
cargo install --path .

Once installed, the tts-tui binary is available from anywhere on your system.

Use the --endpoint flag to point tts-tui at your Deepgram-compatible HTTP endpoint:

Bash
tts-tui --provider deepgram --endpoint https://your-selfhosted-deepgram.example.com/v1/speak

If the endpoint requires an API key, supply it through the DEEPGRAM_API_KEY environment variable or press k inside the running application.

Use self-hosted Deepgram TTS on Amazon SageMaker through the AWS SageMaker Runtime InvokeEndpoint API:

Bash
tts-tui \
  --provider sagemaker \
  --sagemaker-endpoint-name your-sagemaker-endpoint \
  --aws-region us-east-2

The same settings can be supplied with environment variables:

Bash
export TTS_TUI_PROVIDER=sagemaker
export SAGEMAKER_ENDPOINT_NAME=your-sagemaker-endpoint
export AWS_REGION=us-east-2
tts-tui
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu