Metadata-Version: 2.4
Name: livekit-plugins-piper-tts
Version: 0.1.0
Summary: A custom TTS plugin for LiveKit which can be used with self hosted Piper TTS
Home-page: https://github.com/VishnuVardhanJS/livekit-plugins-piper-tts
Author: Vishnu Vardhan JS
Author-email: Vishnu Vardhan JS <vichudsvv@gmail.com>
License-Expression: Apache-2.0
Project-URL: Documentation, https://docs.livekit.io
Project-URL: Website, https://livekit.io/
Project-URL: Repository, https://github.com/VishnuVardhanJS/livekit-plugins-piper-tts
Keywords: voice,ai,realtime,audio,video,livekit,piper-tts,tts
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: livekit-agents>=1.3.3
Requires-Dist: soundfile>=0.13.1
Requires-Dist: requests>=2.32.5

# LiveKit Plugins Piper TTS

## Pre-requisites

The following environment variables need to be set:

| Variable | Description | Example |
|----------|-------------|---------|
| `base_url` | Base URL of the Piper TTS server | `http://localhost:5000` |


## Installation

### Step 1: Install the PiperTTS Server (open source)

Follow the instructions to setup the PiperTTS Web Server:

https://github.com/OHF-Voice/piper1-gpl

### Step 2: Install the LiveKit Plugin

```bash
pip install livekit-plugins-piper-tts

```

## Usage examples

```
from livekit.plugins import piper_tts

....
 session = AgentSession(
        llm=openai.LLM(model="gpt-4o-mini"),
        tts=piper_tts.TTS("http://localhost:5000/"),
        ....
    )

```
