LiveKit docs › Models › STT › Additional models › Gnani

---

# Gnani STT plugin guide

> How to use the Gnani STT plugin for LiveKit Agents.

Available in:
- [ ] Node.js
- [x] Python

## Overview

This plugin allows you to use [Gnani](https://gnani.ai/) Vachana as an STT provider for your voice agents. Gnani provides high-accuracy speech recognition for Indian languages, including multilingual and code-switching scenarios, with both batch recognition and realtime WebSocket streaming.

### Installation

Install the plugin from PyPI:

```shell
uv add "livekit-agents[gnani]~=1.5"

```

### Authentication

The Gnani plugin requires a [Gnani Vachana API key](https://vachana.ai/).

Set the following in your `.env` file:

```shell
GNANI_API_KEY=<your-gnani-api-key>
# Optional
GNANI_ORGANIZATION_ID=<your-organization-id>
GNANI_USER_ID=<your-user-id>

```

### Usage

Use Gnani STT in an `AgentSession` or as a standalone transcription service. For example, you can use this STT in the [Voice AI quickstart](https://docs.livekit.io/agents/start/voice-ai.md).

```python
from livekit.agents import AgentSession
from livekit.plugins import gnani

session = AgentSession(
   stt=gnani.STT(
      language="en-IN",
      sample_rate=16000,
   ),
   # ... llm, tts, etc.
)

```

### Parameters

This section describes some of the available parameters. See the [plugin reference](https://docs.livekit.io/reference/python/livekit/plugins/gnani/index.html.md#livekit.plugins.gnani.STT) for a complete list of all available parameters.

- **`language`** _(LanguageCode)_ (optional) - Default: `en-IN`: [Language code](https://docs.livekit.io/agents/models/stt.md#language-codes) for the input audio. Supported languages vary by mode:

- **Streaming (WebSocket)**: `bn-IN`, `en-IN`, `gu-IN`, `hi-IN`, `kn-IN`, `ml-IN`, `mr-IN`, `pa-IN`, `ta-IN`, `te-IN`, `en-hi-IN-latn`, `en-hi-in-cm`.
- **Batch (REST)**: `bn-IN`, `en-IN`, `gu-IN`, `hi-IN`, `kn-IN`, `ml-IN`, `mr-IN`, `pa-IN`, `ta-IN`, `te-IN`, `en-IN,hi-IN`.
Use `en-hi-IN-latn` or `en-hi-in-cm` for English-Hindi code-mixed audio.

- **`sample_rate`** _(integer)_ (optional) - Default: `16000`: Input audio sample rate in Hz. Supported values: `8000` and `16000`.

## Additional resources

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

- **[Python package](https://pypi.org/project/livekit-plugins-gnani/)**: The `livekit-plugins-gnani` package on PyPI.

- **[Plugin reference](https://docs.livekit.io/reference/python/livekit/plugins/gnani/index.html.md#livekit.plugins.gnani.STT)**: Reference for the Gnani STT plugin.

- **[GitHub repo](https://github.com/livekit/agents/tree/main/livekit-plugins/livekit-plugins-gnani)**: View the source or contribute to the LiveKit Gnani STT plugin.

- **[Gnani site](https://gnani.ai/)**: Gnani's official site and product documentation.

- **[Voice AI quickstart](https://docs.livekit.io/agents/start/voice-ai.md)**: Get started with LiveKit Agents and Gnani.

- **[Gnani TTS](https://docs.livekit.io/agents/models/tts/gnani.md)**: Guide to the Gnani TTS plugin with LiveKit Agents.

---

This document was rendered at 2026-06-21T04:11:31.987Z.
For the latest version of this document, see [https://docs.livekit.io/agents/models/stt/gnani.md](https://docs.livekit.io/agents/models/stt/gnani.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).