Sprag Text-to-Speech

Community-maintained integration. This service is built and maintained by sprag-ai. Pipecat does not test or officially support it. Please report issues and request changes on the source repository. Learn more about community integrations.

Overview

SpragTTSService provides real-time text-to-speech synthesis using Sprag’s WebSocket API.

Source Repository

Source code, examples, and issues for the Sprag integration

Sprag Docs

Official Sprag documentation for Pipecat

Installation

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

uv add pipecat-sprag

Prerequisites

Sprag Account Setup

Before using Sprag TTS, you need:

Sprag Account: Sign up at sprag.ai
API Key: Generate an API key in the Sprag app

Required Environment Variables

SPRAG_API_KEY: Your Sprag API key. May be passed directly via the api_key constructor argument instead.

Configuration

str

default:"None"

Sprag API key. Falls back to the SPRAG_API_KEY environment variable.

str

default:"wss://api.sprag.ai/v1/audio/speech"

Sprag streaming speech WebSocket URL.

float

default:"10.0"

Session setup timeout in seconds.

SpragTTSService.Settings

default:"None"

Runtime-configurable settings. See Settings below.

Settings

Parameter	Type	Default	Description
`model`	`str`	`"chorus"`	Sprag speech model.
`voice`	`str`	`"wade"`	Voice ID: a preset voice or a voice created in your organization.

Changing model or voice at runtime reconnects the session.

Usage

from pipecat_sprag.tts import SpragTTSService

tts = SpragTTSService(settings=SpragTTSService.Settings(voice="marin"))

pipeline = Pipeline([
    transport.input(),
    stt,
    user_aggregator,
    llm,
    tts,
    transport.output(),
    assistant_aggregator,
])

Compatibility

Tested with Pipecat v1.12.0 (pipecat-ai>=1.8,<2). Check the source repository for the latest tested version and changelog.

Get Started

Pipecat Server

Client SDKs

Pipecat Flows

Pipecat Cloud

CLI

Pipecat Context Hub

Sprag Text-to-Speech

Overview

Source Repository

Sprag Docs

Installation

Prerequisites

Sprag Account Setup

Required Environment Variables

Configuration

Settings

Usage

Compatibility

​Overview

Source Repository

Sprag Docs

​Installation

​Prerequisites

​Sprag Account Setup

​Required Environment Variables

​Configuration

​Settings

​Usage

​Compatibility

Overview

Installation

Prerequisites

Sprag Account Setup

Required Environment Variables

Configuration

Settings

Usage

Compatibility