livekit-plugins-gnani 0.2.0

LiveKit Agents plugin for Gnani Vachana speech AI — STT & TTS for Indian languages

livekit-plugins-gnani

LiveKit Agents plugin for Gnani Vachana — high-accuracy Speech-to-Text and low-latency Text-to-Speech for Indian languages.

Vachana is a production-ready speech AI platform by Gnani.ai supporting 10+ Indian languages with real-time streaming, multilingual transcription, and code-switching capabilities.

Installation

pip install livekit-plugins-gnani

This will also install the gnani-vachana core SDK as a dependency.

Prerequisites

You need a Gnani API key. Email [e-mail] to get started — all new accounts receive free credits, no credit card required.

Set your credentials as environment variables:

export GNANI_API_KEY="your-api-key"

# For REST STT only (optional):
export GNANI_ORGANIZATION_ID="your-org-id"
export GNANI_USER_ID="your-user-id"

Quick Start

Speech-to-Text

from livekit.plugins.gnani import STT

stt = STT(language="hi-IN")

# Use with a LiveKit voice agent pipeline

Text-to-Speech

from livekit.plugins.gnani import TTS

tts = TTS(voice="sia")

# Use with a LiveKit voice agent pipeline

Features

STT

• Batch recognition — REST API (POST /stt/v3) for file-based transcription
• Real-time streaming — WebSocket API for live audio transcription with VAD
• 10 Indian languages — bn-IN, en-IN, gu-IN, hi-IN, kn-IN, ml-IN, mr-IN, pa-IN, ta-IN, te-IN
• Code-switching — Hinglish (en-hi-IN-latn) and Hindi-English mixed (en-hi-in-cm) for streaming
• Sample rates — 8 kHz and 16 kHz

TTS

• Chunked synthesis — REST API for single-request audio generation
• Real-time streaming — WebSocket API for low-latency streaming synthesis
• 8 voices — sia, raju, kanika, nikita, ravan, simran, karan, neha
• Configurable output — sample rate (8000–44100), encoding (linear_pcm, oggopus), container (raw, mp3, wav, mulaw, ogg)

Supported Languages

Language	Code
Bengali	bn-IN
English (India)	en-IN
Gujarati	gu-IN
Hindi	hi-IN
Kannada	kn-IN
Malayalam	ml-IN
Marathi	mr-IN
Punjabi	pa-IN
Tamil	ta-IN
Telugu	te-IN

Available Voices

Voice	ID
Sia	sia
Raju	raju
Kanika	kanika
Nikita	nikita
Ravan	ravan
Simran	simran
Karan	karan
Neha	neha

Architecture

gnani-vachana           ← Core SDK (REST, WebSocket, SSE clients)
    ↑
livekit-plugins-gnani   ← This package (LiveKit Agents adapter)

This plugin is a thin adapter that wraps the gnani-vachana SDK into LiveKit's stt.STT and tts.TTS base classes. All connection logic, authentication, and audio format handling lives in the core SDK.

Documentation

• Vachana API Docs
• LiveKit Agents Docs
• gnani-vachana SDK

License

Apache 2.0 — see LICENSE.