Sarvam STT plugin guide | LiveKit Documentation

Available in

Python

Node.js

Overview

This plugin allows you to use Sarvam as an STT provider for your voice agents.

Installation

Install the plugin:

uv add "livekit-agents[sarvam]~=1.4"

pnpm add @livekit/agents-plugin-sarvam@1.x

Authentication

The Sarvam plugin requires a Sarvam API key.

Set SARVAM_API_KEY in your .env file.

Usage

Use Sarvam STT in an AgentSession or as a standalone transcription service. For example, you can use this STT in the Voice AI quickstart.

from livekit.plugins import sarvam

session = AgentSession(
   stt=sarvam.STT(
      language="en-IN",
      model="saaras:v3",
      mode="transcribe",  # default
   ),
   # ... llm, tts, etc.
)

import * as sarvam from '@livekit/agents-plugin-sarvam';

const session = new voice.AgentSession({
    stt: new sarvam.STT({
        languageCode: "en-IN",
        model: "saaras:v3",
        mode: "transcribe",  // default
    }),
    // ... llm, tts, etc.
});

Parameters

This section describes some of the available parameters. See the plugin reference links in the Additional resources section for a complete list of all available parameters.

languagestringOptional

BCP-47 language code. Language support varies by model:

saaras:v3 supports the full set of plugin-supported languages.
saarika:v2.5 and saaras:v2.5 support a smaller subset.

See documentation for a complete list of supported languages.

In Node.js this parameter is called languageCode.

modelstringOptionalDefault: saarika:v2.5

The Sarvam STT model to use. Valid values are:

saarika:v2.5
saaras:v2.5
saaras:v3

saaras:v3 is the recommended model for advanced mode control and broader language support.

modestringOptionalDefault: transcribe

Transcription mode for saaras:v3. Valid values are:

transcribe
translate
verbatim
translit
codemix

Only default transcription behavior is supported for saarika:v2.5 and saaras:v2.5 models.

promptstringOptional

Optional prompt for translation workflows on saaras models.

Additional resources

The following resources provide more information about using Sarvam with LiveKit Agents.

Python

PyPI Reference GitHub

Node.js

NPM Reference GitHub

Sarvam docs

Sarvam's full docs site.

Voice AI quickstart

Get started with LiveKit Agents and Sarvam.

Sarvam TTS

Guide to the Sarvam TTS plugin with LiveKit Agents.