geniete-voice 0.1.0__tar.gz

geniete_voice-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Genie, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

geniete_voice-0.1.0/PKG-INFO

@@ -0,0 +1,52 @@
+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.
+

geniete_voice-0.1.0/README.md

@@ -0,0 +1,31 @@
+# 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.

geniete_voice-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+# Publishes to PyPI as "geniete-voice"
+# Install:  pip install geniete-voice
+#
+# Public package: NO GenieForge dependencies — importable name "geniete_voice".
+[project]
+name = "geniete-voice"
+version = "0.1.0"
+description = "GenieTé Voice Python SDK — text in, speech out for AI agents"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["tts", "voice", "agents", "geniete", "text-to-speech"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = [
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://voice.geniete.com/"
+Documentation = "https://voice.geniete.com/docs/voice/"
+Company = "https://www.genieinc.com/"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "geniete-voice"
+version = "0.1.0"
+description = "GenieTé Voice Python SDK"
+authors = ["Genie, Inc. <renat@geniete.com>"]
+packages = [{ include = "geniete_voice", from = "src" }]
+
+[tool.poetry.dependencies]
+python = ">=3.10"
+httpx = ">=0.27.0"

geniete_voice-0.1.0/src/geniete_voice/__init__.py

@@ -0,0 +1,4 @@
+from .client import AsyncSpeaker, Speaker
+
+__all__ = ["Speaker", "AsyncSpeaker"]
+__version__ = "0.1.0"

geniete_voice-0.1.0/src/geniete_voice/client.py

@@ -0,0 +1,166 @@
+"""
+GenieTé Voice SDK — text in, speech out (voice.geniete.com).
+
+Sync:
+    from geniete_voice import Speaker
+    spk = Speaker(api_key="vk_...", speaker_id="spk_...")
+    spk.say("Deploy finished. All checks green.")        # plays on listen pages
+    url = spk.speak_url("Sixty-second summary ...")      # hosted MP3 link
+    mp3 = spk.speak_bytes("Hello out loud.")             # raw MP3 bytes
+
+Async: AsyncSpeaker with the same methods, awaited.
+
+Listen pages (leave one open anywhere; every say() plays there):
+    link = spk.listen_link(ttl_seconds=86_400)
+"""
+from __future__ import annotations
+
+import uuid
+from typing import Any, Optional
+
+import httpx
+
+DEFAULT_BASE_URL = "https://voice.geniete.com"
+
+
+class VoiceError(RuntimeError):
+    """API refusal with the server's reason (e.g. free_daily_ceiling,
+    insufficient_credits, text_too_long)."""
+
+    def __init__(self, reason: str, detail: Optional[dict] = None) -> None:
+        super().__init__(reason)
+        self.reason = reason
+        self.detail = detail or {}
+
+
+class _Base:
+    def __init__(
+        self,
+        api_key: str,
+        speaker_id: str,
+        base_url: str = DEFAULT_BASE_URL,
+        *,
+        transport: Any = None,   # test seam: httpx transport
+    ) -> None:
+        self.api_key = api_key
+        self.speaker_id = speaker_id
+        self.base_url = base_url.rstrip("/")
+        self._transport = transport
+        self._headers = {
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+        }
+
+    def _speak_body(self, text: str, voice_id: str, **extra: Any) -> dict:
+        body = {
+            "speaker_id": self.speaker_id,
+            "voice_id": voice_id,
+            "text": text,
+            "request_id": extra.pop("request_id", None) or f"sdk_{uuid.uuid4().hex[:16]}",
+        }
+        body.update(extra)
+        return body
+
+    @staticmethod
+    def _raise_for_reason(r: httpx.Response) -> None:
+        if r.status_code < 400:
+            return
+        try:
+            detail = r.json()
+        except Exception:
+            detail = {}
+        raise VoiceError(detail.get("error", f"http_{r.status_code}"), detail)
+
+
+class Speaker(_Base):
+    """Synchronous Voice client, keyed to one speaker."""
+
+    def _client(self) -> httpx.Client:
+        return httpx.Client(timeout=130.0, transport=self._transport)
+
+    def say(self, text: str, voice_id: str = "kanika", **extra: Any) -> dict:
+        """Pump mode: speak on every open listen page; small JSON ack
+        (charged credits + characters), no audio in the response."""
+        with self._client() as c:
+            r = c.post(f"{self.base_url}/public/api/speak", headers=self._headers,
+                       json=self._speak_body(text, voice_id, return_audio=False, **extra))
+            self._raise_for_reason(r)
+            return r.json()
+
+    def speak_url(self, text: str, voice_id: str = "kanika", **extra: Any) -> str:
+        """Hosted MP3 link (kept ~1 day) — plays anywhere, no server."""
+        with self._client() as c:
+            r = c.post(f"{self.base_url}/public/api/speak", headers=self._headers,
+                       json=self._speak_body(text, voice_id, deliver="url", **extra))
+            self._raise_for_reason(r)
+            return r.json()["url"]
+
+    def speak_bytes(self, text: str, voice_id: str = "kanika", **extra: Any) -> bytes:
+        """Raw MP3 bytes in the response body."""
+        with self._client() as c:
+            r = c.post(f"{self.base_url}/public/api/speak", headers=self._headers,
+                       json=self._speak_body(text, voice_id, **extra))
+            self._raise_for_reason(r)
+            return r.content
+
+    def voices(self) -> list[dict]:
+        with self._client() as c:
+            r = c.get(f"{self.base_url}/public/api/voices")
+            self._raise_for_reason(r)
+            return r.json().get("voices", [])
+
+    def listen_link(self, ttl_seconds: Optional[int] = None) -> dict:
+        """Mint a shareable listen-page link (one open seat per link).
+        Returns {url, token, expires_in_seconds}."""
+        with self._client() as c:
+            r = c.post(
+                f"{self.base_url}/public/api/speakers/{self.speaker_id}/listen-links",
+                headers=self._headers,
+                json={"ttl_seconds": ttl_seconds} if ttl_seconds else {},
+            )
+            self._raise_for_reason(r)
+            return r.json()
+
+
+class AsyncSpeaker(_Base):
+    """Async Voice client, keyed to one speaker."""
+
+    def _client(self) -> httpx.AsyncClient:
+        return httpx.AsyncClient(timeout=130.0, transport=self._transport)
+
+    async def say(self, text: str, voice_id: str = "kanika", **extra: Any) -> dict:
+        async with self._client() as c:
+            r = await c.post(f"{self.base_url}/public/api/speak", headers=self._headers,
+                             json=self._speak_body(text, voice_id, return_audio=False, **extra))
+            self._raise_for_reason(r)
+            return r.json()
+
+    async def speak_url(self, text: str, voice_id: str = "kanika", **extra: Any) -> str:
+        async with self._client() as c:
+            r = await c.post(f"{self.base_url}/public/api/speak", headers=self._headers,
+                             json=self._speak_body(text, voice_id, deliver="url", **extra))
+            self._raise_for_reason(r)
+            return r.json()["url"]
+
+    async def speak_bytes(self, text: str, voice_id: str = "kanika", **extra: Any) -> bytes:
+        async with self._client() as c:
+            r = await c.post(f"{self.base_url}/public/api/speak", headers=self._headers,
+                             json=self._speak_body(text, voice_id, **extra))
+            self._raise_for_reason(r)
+            return r.content
+
+    async def voices(self) -> list[dict]:
+        async with self._client() as c:
+            r = await c.get(f"{self.base_url}/public/api/voices")
+            self._raise_for_reason(r)
+            return r.json().get("voices", [])
+
+    async def listen_link(self, ttl_seconds: Optional[int] = None) -> dict:
+        async with self._client() as c:
+            r = await c.post(
+                f"{self.base_url}/public/api/speakers/{self.speaker_id}/listen-links",
+                headers=self._headers,
+                json={"ttl_seconds": ttl_seconds} if ttl_seconds else {},
+            )
+            self._raise_for_reason(r)
+            return r.json()