Sprag LLM

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

SpragLLMService provides chat completion capabilities using Sprag’s OpenAI-compatible 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 LLM services, 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:"https://api.sprag.ai/v1"

Sprag API base URL.

Mapping[str, str]

default:"None"

Extra headers sent with every request.

SpragLLMService.Settings

default:"None"

Runtime-configurable settings. The model defaults to "symphony".

SpragLLMService.Settings inherits from OpenAILLMService.Settings. See the source repository for the authoritative, up-to-date list of settings.

Usage

from pipecat_sprag.llm import SpragLLMService

llm = SpragLLMService(
    settings=SpragLLMService.Settings(
        system_instruction="You are a helpful assistant in a voice conversation.",
    ),
)

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

Overview

Source Repository

Sprag Docs

Installation

Prerequisites

Sprag Account Setup

Required Environment Variables

Configuration

Usage

Compatibility

​Overview

Source Repository

Sprag Docs

​Installation

​Prerequisites

​Sprag Account Setup

​Required Environment Variables

​Configuration

​Usage

​Compatibility

Overview

Installation

Prerequisites

Sprag Account Setup

Required Environment Variables

Configuration

Usage

Compatibility