Metadata-Version: 2.4
Name: polyread
Version: 1.0.0
Summary: PolyRead TTS SDK — ElevenLabs-compatible Python client
License: MIT
License-File: LICENSE
Keywords: tts,text-to-speech,polyread,voice,ai
Requires-Python: >=3.8,<4.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Provides-Extra: pyaudio
Requires-Dist: httpx (>=0.21.2)
Requires-Dist: pyaudio (>=0.2.14) ; extra == "pyaudio"
Requires-Dist: pydantic (>=1.9.2)
Requires-Dist: pydantic-core (>=2.18.2)
Requires-Dist: requests (>=2.20)
Requires-Dist: typing_extensions (>=4.0.0)
Requires-Dist: websockets (>=11.0)
Project-URL: Homepage, https://polyread.ai
Description-Content-Type: text/markdown

# PolyRead TTS — Python SDK

ElevenLabs-compatible SDK for the [PolyRead TTS API](https://polyread.ai).
Switch from ElevenLabs by changing **one line of code**.

## Installation

```bash
pip install polyread
```

## Quick Start

```python
from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="pr_live_...")

audio = client.text_to_speech.convert(
    voice_id="VOICE_ID",
    text="Hello from PolyRead!",
    model_id="polyread-tts-1",
    voice_settings={"stability": 0.5, "similarity_boost": 0.75},
)
```

## Switching from ElevenLabs

| Before (ElevenLabs) | After (PolyRead) |
|---|---|
| `from elevenlabs import ElevenLabs` | `from elevenlabs import ElevenLabs` — **unchanged** |
| `pip install elevenlabs` | `pip install polyread` |
| `ElevenLabs(api_key="el_...")` | `ElevenLabs(api_key="pr_live_...")` |
| `client.text_to_speech.convert(...)` | `client.text_to_speech.convert(...)` — **unchanged** |

All class names, method names, and parameter shapes are identical. Only the package and API key change.

## API Keys

Create an API key from your [PolyRead Developer Dashboard](https://app.polyread.ai/developer).
Keys start with `pr_live_`.

## Supported Models

| model_id | Description |
|---|---|
| `polyread-tts-1` | Standard quality, lowest latency (default) |
| `polyread-tts-1-hd` | Higher quality, slightly higher latency |
| `polyread-multilingual-v1` | 20+ language support |

## Base URL

All requests go to the PolyRead API automatically.
You can override it:

```python
client = ElevenLabs(
    api_key="pr_live_...",
    base_url="https://your-custom-endpoint.com/api",
)
```

## License

MIT

