Skip to main content

livekit-plugins-oogam

Oogam for LiveKit Agents: streaming speech-to-text, text-to-speech (Naad) and Sutra, for 27 Indian languages and English.

Service Class Oogam endpoint
Speech to text oogam.STT wss://platform.oogam.ai/v1/realtime?intent=transcription
Text to speech oogam.TTS POST /v1/audio/speech (streamed PCM)
Sutra oogam.LLM POST /v1/chat/completions

Install

pip install "livekit-agents[silero]~=1.8" livekit-plugins-oogam python-dotenv

Python 3.10 or later, LiveKit Agents 1.8. Create an API key with the NAAD product (and SUTRA for the LLM) on the Oogam Platform and set OOGAM_API_KEY.

Quick start

from dotenv import load_dotenv

from livekit import agents
from livekit.agents import Agent, AgentServer, AgentSession
from livekit.plugins import oogam, silero

load_dotenv()


class Assistant(Agent):
    def __init__(self) -> None:
        super().__init__(
            instructions="You are a helpful assistant. Reply in one or two short spoken sentences, in the caller's language.",
        )

    async def on_enter(self) -> None:
        self.session.generate_reply(instructions="Greet the caller in Hindi.")


server = AgentServer()


@server.rtc_session()
async def entrypoint(ctx: agents.JobContext):
    session = AgentSession(
        stt=oogam.STT(language="hi"),
        llm=oogam.LLM(),
        tts=oogam.TTS(voice="aditi", language="hi"),
        vad=silero.VAD.load(),
    )
    await session.start(room=ctx.room, agent=Assistant())


if __name__ == "__main__":
    agents.cli.run_app(server)
python agent.py console   # talk to it in the terminal
python agent.py dev       # join a LiveKit room

Turn-taking

Keep a VAD, as the quick start does. The STT declares manual_flush: when LiveKit decides the caller has stopped — Silero's end of speech, or your turn detector's verdict — it flushes the stream and the plugin sends Oogam finalize, so the turn closes at that moment. The VAD also lets callers interrupt the agent.

Measured on live calls (Hindi and Indian English, LiveKit Agents 1.8, Sutra and Oogam TTS, 14 calls):

Setup Transcript after the caller stops Agent starts speaking
vad=silero.VAD.load() 0.6–0.75 s 1.8–2.0 s
silero.VAD.load(min_silence_duration=0.3) 0.6–0.75 s 1.55–1.85 s
turn_detection="stt", min_delay 0.07 0.65–0.8 s 1.75–1.95 s
turn_detection="stt", default min_delay 0.65–0.75 s 2.1–2.3 s

Most of the time to the agent's first word is Sutra and the first sentence of speech. A shorter min_silence_duration answers sooner, but may cut in on a caller who pauses mid-sentence — test it with your callers.

To let Oogam end each turn by itself (each transcript then arrives as START_OF_SPEECH, FINAL_TRANSCRIPT, END_OF_SPEECH), lower LiveKit's endpointing delay too, or it waits another 0.5 s after every transcript:

session = AgentSession(
    ...,
    turn_handling={"turn_detection": "stt", "endpointing": {"min_delay": 0.07}},
)

Languages

language takes Oogam's short codes (hi, gu, ta, en-IN, bho …), BCP-47 tags (hi-IN, gu-IN) or Oogam's 3-letter speech codes (HIN). Oogam does not auto-detect: a session starts in the language you give it. Plain en is American English; use en-IN for Indian English.

To follow a caller who switches language mid-call:

stt = oogam.STT(language="hi", auto_switch=True, candidates=["hi", "en-IN", "gu"])

Each transcript carries the language it was heard in; move the TTS with it using tts.update_options(language=...).

Sutra and tools

Sutra does not support function calling yet: an agent with tools gets a 400 (tools_not_supported). For agents that need tools, keep oogam.STT and oogam.TTS and pair them with an LLM that supports tools.

Billing

From your prepaid wallet: speech to text per second the session is open, text to speech per character, Sutra per token. An empty wallet is refused with a 402.

MIT licensed. Maintained by DWET Labs.

Metadata

Release files for livekit-plugins-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 livekit-plugins-oogam 0.1.0
File Size Uploaded Provenance Actions
livekit_plugins_oogam-0.1.0.tar.gz 20.0 kB Without provenance Details for livekit_plugins_oogam-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 35.4 kB

Release files / livekit_plugins_oogam-0.1.0.tar.gz

Download URL livekit_plugins_oogam-0.1.0.tar.gz
Size 20.0 kB
Tags Source
SHA-256 checksum
How to use checksums
9a19ae50713321c1cbb45ddcba3013c49e54bd4ddaba7273fe343bf2a00a9ef0
BLAKE2b-256 checksum
How to use checksums
863abc176c090aafc2c1be7402c917e77629e7394441d328ab2a71628f86c68d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.11

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

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

Security for livekit-plugins-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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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