build a voice agent with pipecat

building a real-time voice bot? skip the websocket plumbing and use pipecat-rumik, our official pipecat tts service. it drops rumik straight into a pipecat pipeline with streaming audio, metrics, and interruption handling already wired up.

pip install pipecat-rumik

pick a service

it ships two tts services. pick one for your transport:

service	transport	best for
`RumikTTSService`	websocket	interactive voice agents that need interruption-aware, streaming tts.
`RumikHttpTTSService`	http	simpler request/response synthesis and batch-style flows.

add it to a pipeline

settings map to the same request fields as the rest api.

import os
from pipecat_rumik import RumikTTSService

# muga: our more expressive voice
tts = RumikTTSService(
    api_key=os.environ["RUMIK_API_KEY"],
    gateway_url=os.environ["RUMIK_GATEWAY_URL"],
    settings=RumikTTSService.Settings(model="muga"),
)

# mulberry: our faster voice, steered by a description + preset speaker
tts = RumikTTSService(
    api_key=os.environ["RUMIK_API_KEY"],
    gateway_url=os.environ["RUMIK_GATEWAY_URL"],
    settings=RumikTTSService.Settings(
        model="mulberry",
        voice="ira",                # sent to Rumik as "speaker"
        description="a warm 30s indian voice, smooth timbre, conversational pacing, like a friendly narrator",
    ),
)

# Then drop `tts` into your Pipecat Pipeline alongside your STT + LLM services.

set RUMIK_API_KEY to a key from your dashboard and RUMIK_GATEWAY_URL to https://silk-api.rumik.ai. see the pypi package for runnable voice-agent examples, settings, and event handlers.

settings

RumikTTSSettings is shared by RumikTTSService.Settings and RumikHttpTTSService.Settings. it maps to rumik request fields:

setting	request field	notes
`model`	`model`	`muga` or `mulberry`.
`voice`	`speaker`	optional. a named voice, e.g. `ira`.
`description`	`description`	required for `mulberry`. expressive voice description.
`temperature`	`temperature`	optional sampling temperature.
`top_p`	`top_p`	optional nucleus sampling value.
`top_k`	`top_k`	optional top-k sampling value.

next: hand your coding agent the rumik tts skill so it integrates all of this correctly on the first try.

documentation

sdk

integrations

cookbook

api reference

build a voice agent with pipecat

pick a service

add it to a pipeline

settings

​pick a service

​add it to a pipeline

​settings

pick a service

add it to a pipeline

settings