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