Metadata-Version: 2.4
Name: livekit-plugins-boson
Version: 0.1.0
Summary: LiveKit Agents plugin for Boson AI Higgs Audio TTS.
Project-URL: Documentation, https://docs.boson.ai/models/higgs-audio-tts/overview
Project-URL: Source, https://github.com/Ao-Last/livekit-plugins-extra
Project-URL: Issues, https://github.com/Ao-Last/livekit-plugins-extra/issues
Author: Ao-Last
License-Expression: Apache-2.0
Keywords: ai,audio,boson,livekit,realtime,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
Requires-Dist: aiohttp~=3.10
Requires-Dist: livekit-agents<2,>=1.5.0
Description-Content-Type: text/markdown

# Boson AI plugin for LiveKit Agents

Community-maintained LiveKit Agents plugin for Boson AI Higgs Audio TTS.

This package is unofficial and not currently maintained by Boson AI or LiveKit.

## Installation

```bash
pip install livekit-plugins-boson
```

## Prerequisites

Set your Boson API key:

```bash
export BOSON_API_KEY=...
```

## Usage

```python
from livekit.plugins import boson

tts = boson.TTS()
```

Use a preset or registered Boson voice:

```python
tts = boson.TTS(voice="default")
```

Use one-off reference audio cloning:

```python
tts = boson.TTS(
    ref_audio="https://example.com/reference.wav",
    ref_text="Transcript of the reference audio.",
)
```

Streaming synthesis uses Boson's raw PCM stream and feeds it directly into the
LiveKit TTS pipeline.
