Pipecat integration guide

Keep your Pipecat bot where it runs and route its speech to text and text to speech through SLNG. You can also point the language model at the SLNG Context Router. Your transport, VAD, turn-taking, prompts, tools, and pipeline order stay as they are. The SLNG Pipecat services stream STT and TTS over WebSocket. Use them for interactive agents that need low latency and mid-utterance interruption. There are two ways to do it. Set up the layers in the dashboard and copy the migration prompt for your coding agent, or make the edits yourself.

Prerequisites

A running Pipecat bot with Python 3.11 or later.
pipecat-ai>=1.8.0 in your project.
An SLNG API key. See Create your API key.
A BYOK LLM key registered in your org, so the router has a model to route to. See Bring your own key.
For the assisted path, a coding agent that supports skills.

The pipecat-slng package is tested with Pipecat v1.8.0.

Set up your API key

Set SLNG_API_KEY in your environment. The examples below read it without putting the key in your source code.

export SLNG_API_KEY="your-slng-api-key"

Set up in the dashboard

Improving an agent is à la carte. Turn on speech to text, the language model, text to speech, or any mix of the three. Choose the models, voice, language, and routing region you want. The dashboard builds a migration prompt from your choices.

Choose Pipecat

Open the Improve my agent flow and choose Pipecat. The flow keeps your existing bot in your own codebase and generates the changes for the layers you select.

Improve my agent flow with Pipecat highlighted — Choose Pipecat in the Improve my agent flow.

Set up Listen

Turn on speech to text and choose the model and language. Leave it off to keep your current speech to text service.

Listen section with the Include STT toggle on — Turn on Listen and pick a speech to text model.

Set up Think

Turn on the language model and choose the model. The Context Router option is available in your selected region.

Think section with the language model turned on and a model chosen — Think turned on with a language model selected.

Set up Speak

Turn on text to speech and choose the model and voice. Leave it off to keep your current text to speech service.

Speak section with the Include TTS toggle highlighted — Use the Include TTS toggle to turn text to speech on or off.

Copy the prompt

Click Integrate in the top right, then Copy prompt in the modal. The dashboard generates a prompt for the platform and layers you selected. Hand it to your coding agent. It installs the pipecat-migration skill and applies the changes to your bot.

The Integrate button in the top right of the project — Click Integrate in the top right.

The shared Integrate modal with a Copy prompt button — Copy the generated prompt.

The screenshots show the shared dashboard controls. The prompt content is generated for the platform you selected.

Example prompt

Your model IDs, voice, language, and routing region come from what you picked.

# Migrate this Pipecat bot to SLNG-hosted STT/TTS and the SLNG Context Router

Use the SLNG `pipecat-migration` skill to replace speech to text and text
to speech with `SlngSTTService` and `SlngTTSService` from `pipecat-slng`.
Replace the LLM with Pipecat's `OpenAILLMService` pointed at the SLNG Context
Router using `bedrock-mantle/nvidia.nemotron-nano-3-30b:latest`.

## Install the skill
```bash
npx skills add slng-ai/skills pipecat-migration
```

## Selected stack
- STT: `soniox/speech-ai:rt-v5`
- TTS: `slng/fish/tts:s2.1-pro`
- Voice: `1258154bb41540c7b9dc0d10cd6704bf`
- Language: English (`en`)
- Region: Germany, via `world_part="eu-west"`
- LLM: SLNG Context Router, model `bedrock-mantle/nvidia.nemotron-nano-3-30b:latest` at `https://eu-west.context-router.slng.ai/v1`

## Instructions for the coding agent
1. Discover the entrypoint, package manager, environment loading, and
   current STT, TTS, and LLM wiring before editing. Do not assume file
   names.
2. Establish a rollback point with a clean git tree.
3. Validate `SLNG_API_KEY` without printing it.
4. Install `pipecat-slng` and import-probe
   `from pipecat_slng import SlngSTTService, SlngTTSService`.
5. Replace only the STT and TTS constructors that feed `Pipeline([...])`.
   Keep the transport, VAD, context aggregators, and pipeline order
   intact.
6. Point `OpenAILLMService` at the SLNG Context Router endpoint.
7. Never inline API keys. Use stable agent and session identifiers in
   request headers, then verify one spoken turn from STT through the LLM
   to TTS.

Model routes and regions

Model IDs use the provider/model:variant format, and the slng/ prefix selects an SLNG-hosted model. The examples pin requests to Germany with world_part="eu-west". Models differ by region, so check models by region before you pick one. For model identifiers, BYOK with provider_key, and region routing, see the Pipecat plugin reference.

Edit the code yourself

If you would rather not use a coding agent, make the same edits directly. The removed lines below depend on your current providers, so match them to your code.

Install the plugin

Use your project’s package manager.

uv add pipecat-slng

Point STT and TTS at SLNG

Import the SLNG services and swap only the two constructors that feed Pipeline([...]). Pass the API key through the environment, never as a literal.

+ import os
- from pipecat.services.deepgram.stt import DeepgramSTTService
- from pipecat.services.cartesia.tts import CartesiaTTSService
+ from pipecat_slng import SlngSTTService, SlngTTSService

- stt = DeepgramSTTService(
-     api_key=os.environ["DEEPGRAM_API_KEY"],
-     settings=DeepgramSTTService.Settings(model="nova-3"),
- )
- tts = CartesiaTTSService(
-     api_key=os.environ["CARTESIA_API_KEY"],
-     settings=CartesiaTTSService.Settings(voice="<your voice>"),
- )
+ stt = SlngSTTService(
+     api_key=os.environ["SLNG_API_KEY"],
+     world_part="eu-west",
+     model="soniox/speech-ai:rt-v5",
+     language="en",
+ )
+ tts = SlngTTSService(
+     api_key=os.environ["SLNG_API_KEY"],
+     world_part="eu-west",
+     model="slng/fish/tts:s2.1-pro",
+     voice="1258154bb41540c7b9dc0d10cd6704bf",
+     language="en",
+ )

Keep the model, voice, language, and routing region you selected in the dashboard. world_part="eu-west" is an example for the Germany region. Use the region code from your dashboard prompt if it differs. Each service takes its own world_part.

Point the LLM at the SLNG Context Router

Use Pipecat’s OpenAI-compatible service against the router. Pass stable agent and session identifiers in the headers, not random values per request.

from pipecat.services.openai import OpenAILLMService

llm = OpenAILLMService(
    api_key=os.environ["SLNG_API_KEY"],
    base_url="https://eu-west.context-router.slng.ai/v1",  # keep the same region as STT and TTS
    settings=OpenAILLMService.Settings(
        model="bedrock-mantle/nvidia.nemotron-nano-3-30b:latest",
    ),
    default_headers={
        "X-Slng-Agent-Id": agent_id,
        "X-Slng-Session-Id": session_id,
    },
)

pipecat-slng provides STT and TTS services. The router uses Pipecat’s OpenAILLMService.

Verify

Run one spoken turn through your bot’s transport and confirm that the pipeline completes speech to text, the LLM, and text to speech. Keep the existing pipeline order:

pipeline = Pipeline([
    transport.input(),
    stt,
    context_aggregator.user(),
    llm,
    tts,
    transport.output(),
    context_aggregator.assistant(),
])

Next steps

Which models are available for other speech models and voices you can route through SLNG.

Get started

Regions

Execution layer

Agent Builder

Models

Integrate

Prerequisites

Set up your API key

Set up in the dashboard

Model routes and regions

Edit the code yourself

Next steps

​Prerequisites

​Set up your API key

​Set up in the dashboard

​Model routes and regions

​Edit the code yourself

​Next steps

Prerequisites

Set up your API key

Set up in the dashboard

Model routes and regions

Edit the code yourself

Next steps