Metadata-Version: 2.5
Name: livekit-plugins-kalpa
Version: 1.8.11
Summary: Agent Framework plugin for Kalpa text-to-speech.
Project-URL: Documentation, https://docs.livekit.io
Project-URL: Website, https://livekit.io/
Project-URL: Source, https://github.com/livekit/agents
Author-email: LiveKit <hello@livekit.io>
License-Expression: Apache-2.0
Keywords: ai,audio,kalpa,livekit,realtime,text-to-speech,tts,voice
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10.0
Requires-Dist: livekit-agents>=1.8.11
Description-Content-Type: text/markdown

# Kalpa plugin for LiveKit Agents

Support for text-to-speech with [Kalpa](https://kalpalabs.ai/) in LiveKit Agents.

See the [Kalpa integration docs](https://docs.livekit.io/agents/models/tts/kalpa/) for more information, and the [Kalpa docs](https://docs.kalpalabs.ai/text-to-speech) for the API, models and voices.

## Installation

```bash
pip install livekit-plugins-kalpa
```

## Pre-requisites

You'll need an API key from Kalpa. It can be set as an environment variable: `KALPA_API_KEY`. You can create one [here](https://kalpalabs.ai/dashboard/keys/).

## Usage

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

session = AgentSession(
    tts=kalpa.TTS(voice="18c26f49-9f9c-400c-bec9-7467f28e1db5"),  # Arjun
    # ... stt, llm, etc.
)
```

`kalpa-tts-1` speaks English and Hindi. List the voices with `GET https://api.kalpalabs.ai/v1/voices`.
