Metadata-Version: 2.4
Name: geniete-voice
Version: 0.1.0
Summary: GenieTé Voice Python SDK — text in, speech out for AI agents
License: MIT
License-File: LICENSE
Keywords: tts,voice,agents,geniete,text-to-speech
Author: Genie, Inc.
Author-email: renat@geniete.com
Requires-Python: >=3.10
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Dist: httpx (>=0.27.0)
Project-URL: Company, https://www.genieinc.com/
Project-URL: Documentation, https://voice.geniete.com/docs/voice/
Project-URL: Homepage, https://voice.geniete.com/
Description-Content-Type: text/markdown

# geniete-voice

Python SDK for [GenieTé Voice](https://voice.geniete.com/) — text in,
speech out for AI agents. One call turns words into an MP3, a hosted
link, or live speech on a page you leave open anywhere.

```bash
pip install geniete-voice
```

```python
from geniete_voice import Speaker

spk = Speaker(api_key="vk_...", speaker_id="spk_...")

spk.say("Deploy finished. All checks green.")     # plays on your listen pages
url = spk.speak_url("Sixty-second summary ...")   # hosted MP3, plays anywhere
mp3 = spk.speak_bytes("Hello out loud.")          # raw MP3 bytes

link = spk.listen_link(ttl_seconds=86_400)        # standing speaker page
print(link["url"])                                # open on any device
```

Async twin: `AsyncSpeaker`, same methods awaited.

Create speakers and API keys in the [Voice console](https://voice.geniete.com/admin/).
Full docs: <https://voice.geniete.com/docs/voice/>. Errors raise
`VoiceError` with the server's reason (`insufficient_credits`,
`free_daily_ceiling`, `text_too_long`, ...).

MIT © Genie, Inc.

