Fonada TTS plugin

livekit-plugins/livekit-plugins-fonadalabs/README.md

@@ -0,0 +1,90 @@
+# FonadaLabs TTS plugin for Livekit Agents
+
+A LiveKit plugin that integrates FonadaLabs TTS API using WebSocket, enabling high-quality text-to-speech synthesis with multiple Indian voices in LiveKit agents.
+
+## Features
+
+- 🎙️ **High-Quality TTS**: Uses FonadaLabs TTS API for natural-sounding speech
+- 🇮🇳 **Rich Indian Voices**: 110+ voices across Hindi, Tamil, Telugu, and English
+- ⚡ **Real-time Streaming**: WebSocket-based streaming for low-latency audio
+- 🔒 **Secure**: API key authentication
+- 🚀 **Easy Integration**: Simple plugin interface for LiveKit agents
+- 🔄 **Dynamic Catalog**: Supported languages and voices are fetched live from the API
+
+## Installation
+
+```bash
+pip install livekit-plugins-fonadalabs
+```
+
+## Pre-requisites
+
+You'll need an API key from FonadaLabs (https://fonadalabs.ai). It can be set as an environment variable: `FONADALABS_API_KEY`
+
+
+
+## Supported Languages & Voices
+
+> **Note:** The full list of supported languages and voices is fetched dynamically from the FonadaLabs API at runtime (`https://api.fonada.ai/supported-voices`). The list below reflects the currently available voices.
+
+### 🇮🇳 Hindi (default) — 18 voices
+
+| | | | | |
+|---|---|---|---|---|
+| Dhruv | Vaanee *(default)* | Swastik | Laksh | Raag |
+| Sarvagya | Komal | Meghra | Pancham | Tara |
+| Sharad | Kritika | Mandra | Karn | Gauri |
+| Ruhi | Roshini | Parikshit | | |
+
+---
+
+### 🎵 Tamil — 15 voices
+
+| | | | | |
+|---|---|---|---|---|
+| Vaani | Isai | Thalam | Swaram | Madhuri |
+| Naadham | Rachna | Pallavi | Mrityunjay | Malika |
+| Yamini | Tilak | Dhruv | Sanket | Rudraksh |
+
+---
+
+### 🎶 Telugu — 60 voices
+
+| | | | | |
+|---|---|---|---|---|
+| Ansh | Dhruv | Aadhira | Aahana | Aakriti |
+| Ridhima | Vaani | Shaury | Bhavyaa | Tanuj |
+| Utkarsh | Adyaa | Raagini | Kanika | Madhav |
+| Malini | Priya | Mala | Dhairy | Shruti |
+| Tara | Shubhra | Mandara | Tanya | Sara |
+| Rudrika | Ruhi | Sameer | Geetika | Naitik |
+| Kartik | Naira | Meghvani | Sneha | Sonika |
+| Nikunj | Sonia | Mridul | Shobha | Gunika |
+| Yuvaan | Abhishek | Dhruvika | Hardik | Raj |
+| Raghav | Sanatan | Tanmay | Sanjana | Niharika |
+| Ruchika | Sonakshi | Aaliya | Aanchal | Vartika |
+| Rihaan | Divya | Taarini | Divyansh | Pavani |
+
+---
+
+### 🌐 English — 18 voices
+
+| | | | | |
+|---|---|---|---|---|
+| Dhruv | Vaanee *(default)* | Swastik | Laksh | Raag |
+| Sarvagya | Komal | Meghra | Pancham | Tara |
+| Sharad | Kritika | Mandra | Karn | Gauri |
+| Ruhi | Roshini | Parikshit | | |
+
+---
+
+## Language Specification
+
+You can specify the language either by **display name**:
+
+| Display Name |
+|---|
+| Hindi |
+| English |
+| Tamil |
+| Telugu |

livekit-plugins/livekit-plugins-fonadalabs/livekit/plugins/fonadalabs/__init__.py

@@ -0,0 +1,48 @@
+"""FonadaLabs plugin for LiveKit Agents
+
+Provides high-quality Text-to-Speech for Indian languages via the FonadaLabs API.
+See https://fonada.in for more information.
+"""
+
+from .models import (
+    TTSEnglishVoice,
+    TTSHindiVoice,
+    TTSLanguages,
+    TTSTamilVoice,
+    TTSTeluguVoice,
+    TTSVoice,
+)
+from .tts import TTS
+from .version import __version__
+
+__all__ = [
+    "TTS",
+    "TTSLanguages",
+    "TTSVoice",
+    "TTSHindiVoice",
+    "TTSTamilVoice",
+    "TTSTeluguVoice",
+    "TTSEnglishVoice",
+    "__version__",
+]
+
+from livekit.agents import Plugin
+
+from .log import logger
+
+
+class FonadaLabsPlugin(Plugin):
+    def __init__(self) -> None:
+        super().__init__(__name__, __version__, __package__, logger)
+
+
+Plugin.register_plugin(FonadaLabsPlugin())
+
+# Cleanup docs of unexported modules
+_module = dir()
+NOT_IN_ALL = [m for m in _module if m not in __all__]
+
+__pdoc__ = {}
+
+for n in NOT_IN_ALL:
+    __pdoc__[n] = False

livekit-plugins/livekit-plugins-fonadalabs/livekit/plugins/fonadalabs/log.py

@@ -0,0 +1,5 @@
+"""Logging configuration for FonadaLabs TTS plugin."""
+
+import logging
+
+logger = logging.getLogger("livekit.plugins.fonadalabs")

livekit-plugins/livekit-plugins-fonadalabs/livekit/plugins/fonadalabs/models.py

@@ -0,0 +1,176 @@
+"""FonadaLabs TTS model types — languages and voices available on the API.
+
+.. note::
+    **This file is auto-generated.**
+    Re-run ``python scripts/generate_fonadalabs_models.py`` to refresh it
+    whenever FonadaLabs adds new voices or languages.
+
+    Generated: 2026-04-02 00:00 UTC
+    Source:    https://api.fonada.ai/supported-voices
+
+These ``Literal`` types give IDEs autocomplete and let mypy catch typos at
+type-check time.  The :class:`~livekit.plugins.fonadalabs.TTS` class accepts
+either a typed constant *or* a plain ``str``, so you can still pass a raw
+string if the API adds new voices before this file is regenerated.
+
+Example::
+
+    from livekit.plugins import fonadalabs
+
+    tts = fonadalabs.TTS(
+        language="Hindi",
+        voice="Vaanee",
+    )
+"""
+
+from __future__ import annotations
+
+from typing import Literal
+
+# ---------------------------------------------------------------------------
+# Languages
+# ---------------------------------------------------------------------------
+
+TTSLanguages = Literal["English", "Hindi", "Tamil", "Telugu"]
+"""Supported language display names accepted by the FonadaLabs TTS API."""
+
+# ---------------------------------------------------------------------------
+# Per-language voice literals
+# ---------------------------------------------------------------------------
+
+TTSEnglishVoice = Literal[
+    "Dhruv",
+    "Vaanee",
+    "Swastik",
+    "Laksh",
+    "Raag",
+    "Sarvagya",
+    "Komal",
+    "Meghra",
+    "Pancham",
+    "Tara",
+    "Sharad",
+    "Kritika",
+    "Mandra",
+    "Karn",
+    "Gauri",
+    "Ruhi",
+    "Roshini",
+    "Parikshit",
+]
+"""18 English voices available on the FonadaLabs TTS API."""
+
+TTSHindiVoice = Literal[
+    "Dhruv",
+    "Vaanee",
+    "Swastik",
+    "Laksh",
+    "Raag",
+    "Sarvagya",
+    "Komal",
+    "Meghra",
+    "Pancham",
+    "Tara",
+    "Sharad",
+    "Kritika",
+    "Mandra",
+    "Karn",
+    "Gauri",
+    "Ruhi",
+    "Roshini",
+    "Parikshit",
+]
+"""18 Hindi voices available on the FonadaLabs TTS API."""
+
+TTSTamilVoice = Literal[
+    "Vaani",
+    "Isai",
+    "Thalam",
+    "Swaram",
+    "Madhuri",
+    "Naadham",
+    "Rachna",
+    "Pallavi",
+    "Mrityunjay",
+    "Malika",
+    "Yamini",
+    "Tilak",
+    "Dhruv",
+    "Sanket",
+    "Rudraksh",
+]
+"""15 Tamil voices available on the FonadaLabs TTS API."""
+
+TTSTeluguVoice = Literal[
+    "Ansh",
+    "Dhruv",
+    "Aadhira",
+    "Aahana",
+    "Aakriti",
+    "Ridhima",
+    "Vaani",
+    "Shaury",
+    "Bhavyaa",
+    "Tanuj",
+    "Utkarsh",
+    "Adyaa",
+    "Raagini",
+    "Kanika",
+    "Madhav",
+    "Malini",
+    "Priya",
+    "Mala",
+    "Dhairy",
+    "Shruti",
+    "Tara",
+    "Shubhra",
+    "Mandara",
+    "Tanya",
+    "Sara",
+    "Rudrika",
+    "Ruhi",
+    "Sameer",
+    "Geetika",
+    "Naitik",
+    "Kartik",
+    "Naira",
+    "Meghvani",
+    "Sneha",
+    "Sonika",
+    "Nikunj",
+    "Sonia",
+    "Mridul",
+    "Shobha",
+    "Gunika",
+    "Yuvaan",
+    "Abhishek",
+    "Dhruvika",
+    "Hardik",
+    "Raj",
+    "Raghav",
+    "Sanatan",
+    "Tanmay",
+    "Sanjana",
+    "Niharika",
+    "Ruchika",
+    "Sonakshi",
+    "Aaliya",
+    "Aanchal",
+    "Vartika",
+    "Rihaan",
+    "Divya",
+    "Taarini",
+    "Divyansh",
+    "Pavani",
+]
+"""60 Telugu voices available on the FonadaLabs TTS API."""
+
+# ---------------------------------------------------------------------------
+# Combined voice type (union of all per-language literals)
+# ---------------------------------------------------------------------------
+
+TTSVoice = TTSEnglishVoice | TTSHindiVoice | TTSTamilVoice | TTSTeluguVoice
+"""Union of all voices across every supported language.
+
+Pass this (or a plain ``str``) as the ``voice`` argument to :class:`TTS`.
+"""