Skip to main content

pipecat-oogam

Oogam speech services for Pipecat: streaming speech-to-text, streaming text-to-speech and the Sutra conversation model, for 27 Indian languages and English.

Service Oogam endpoint What it does
OogamSTTService wss://platform.oogam.ai/v1/realtime?intent=transcription Streaming STT. Final transcripts; finalizes the turn the moment Pipecat's VAD says the user stopped.
OogamTTSService POST /v1/audio/speech (stream: true, response_format: "pcm") Streaming TTS — 24 kHz PCM played as it is generated.
OogamLLMService POST /v1/chat/completions Sutra (sutra-conversation) through Pipecat's OpenAI service.
pip install pipecat-oogam

Requires Python 3.11+, Pipecat 1.16 or later (1.x) and an Oogam API key with the NAAD product enabled. Tested with Pipecat v1.16.0.

Maintained by DWET Labs, the team behind Oogam. Integration guide: oogam.ai/integrations/pipecat.

Speech-to-text

from pipecat.transcriptions.language import Language
from pipecat_oogam import OogamSTTService

stt = OogamSTTService(
    api_key=os.environ["OOGAM_API_KEY"],
    settings=OogamSTTService.Settings(language=Language.HI),
)

Turn-taking stays with your pipeline. Oogam's own end-of-turn detection waits for 700 ms of silence. With this service you do not wait for it: when Pipecat's VAD reports that the user stopped speaking, the service sends Oogam finalize and Oogam closes the turn straight away. Smart Turn — Pipecat's default — or any other turn strategy then decides whether the user's turn is really over, exactly as with any other streaming STT. Set finalize_on_vad_stop=False only if you want Oogam to decide instead.

Each transcript is final. Measured on the live engine (12 Nov 2026): with finalize the transcript arrives about 0.33 s after the caller stops, against about 0.8 s when Oogam waits out its own silence window. If a caller pauses for 0.8 s or more mid-sentence, Oogam closes a turn there and the rest arrives as a second transcript; Pipecat's user aggregator joins them, so Smart Turn still decides when the agent replies. (If Oogam ever re-transcribes a turn with replace, the service pushes only the new words.)

The language must be given — Oogam does not auto-detect. To follow a caller who switches language mid-call, turn on auto-switch:

stt = OogamSTTService(
    api_key=os.environ["OOGAM_API_KEY"],
    settings=OogamSTTService.Settings(
        language=Language.HI,
        auto_switch=True,
        candidates=[Language.HI, Language.EN_IN, Language.GU],
    ),
)

@stt.event_handler("on_language_changed")
async def on_language_changed(service, from_code, to_code, reason):
    # e.g. switch the TTS language to match
    await task.queue_frame(TTSUpdateSettingsFrame(delta=OogamTTSService.Settings(language=to_code)))

Auto-switch acts on Oogam's language hint, which comes after the turn it was detected in — so the first sentence after a switch is transcribed in the old language, and the switch applies from the next one. Changing language with an STTUpdateSettingsFrame re-pins the live session without reconnecting.

Setting Default
language Language.HI A Pipecat Language or an Oogam short code (hi, en-IN, bho).
vad_end_silence_ms Oogam's (700) 700–5000. Reserved: sent to Oogam, but the current engine does not act on it.
auto_switch False Follow a caller who changes language.
candidates any Languages a call may switch to.
min_confidence 0.6 Hint confidence needed to switch.

Audio is sent at 16 kHz mono PCM16; Pipecat resamples whatever your transport delivers.

Text-to-speech

async with aiohttp.ClientSession() as session:
    tts = OogamTTSService(
        api_key=os.environ["OOGAM_API_KEY"],
        aiohttp_session=session,
        settings=OogamTTSService.Settings(voice="aditi", language=Language.HI),
    )

voice is a preset id (aditi, arjun, …) or a cloned voice id from GET /v1/voices. Set language deliberately: Oogam falls back to Hindi for a code it does not know.

Sutra

llm = OogamLLMService(api_key=os.environ["OOGAM_API_KEY"])

No function calling yet. /v1/chat/completions answers a request that carries tools with 400 tools_not_supported, so do not register tools on this service. For tool use, keep Oogam for STT and TTS and pair them with an LLM service that supports tools.

A complete agent

examples/voice_agent.py (in the source distribution, and on oogam.ai/integrations/pipecat) runs Oogam STT → Sutra → Oogam TTS with Silero VAD and Smart Turn, in the browser through Pipecat's development runner:

pip install "pipecat-ai[runner,webrtc,silero,local-smart-turn-v3]" pipecat-oogam
OOGAM_API_KEY=sk-setu-… python examples/voice_agent.py

Billing

Streaming STT is billed at the speech-to-text rate per second the socket is open, TTS per character as on the REST API, and Sutra per token.

Developing

pip install -e ".[dev]"
pytest

Tests that need a running Oogam gateway are skipped unless OOGAM_DEV_STACK points at one.

Support

support@dwetlabs.com · Streaming STT reference

Metadata

Release files for pipecat-oogam 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pipecat-oogam 0.1.0
File Size Uploaded Provenance Actions
pipecat_oogam-0.1.0.tar.gz 17.6 kB Without provenance Details for pipecat_oogam-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pipecat-oogam 0.1.0
File Interpreter ABI Platform Actions
pipecat_oogam-0.1.0-py3-none-any.whl Python 3 none any Details for pipecat_oogam-0.1.0-py3-none-any.whl

Total release size: 33.0 kB

Release files / pipecat_oogam-0.1.0.tar.gz

Download URL pipecat_oogam-0.1.0.tar.gz
Size 17.6 kB
Tags Source
SHA-256 checksum
How to use checksums
4bc23df4073e1dfb12121bc6205f3b0b6621d741f36d81e771a2da5d5bd89ad9
BLAKE2b-256 checksum
How to use checksums
d08b4aab77e0cb66d12086dc97046f4e2a0b0a49348b60e4f0eecae7affbea7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.11

Release files / pipecat_oogam-0.1.0-py3-none-any.whl

Download URL pipecat_oogam-0.1.0-py3-none-any.whl
Size 15.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d156e61912e332e4b870fe43548cac4822c870896746f55709197ccdae061257
BLAKE2b-256 checksum
How to use checksums
fa49c78d967be37d9ed305076ca6e745b6ac6e6ba9dd4dd4637162e2d5947381
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.11

Security for pipecat-oogam 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page