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
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.