bevyra-hosted 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,108 @@
1
+ """Hosted BeVyra avatar sessions. Avatar models remain on BeVyra's server."""
2
+ from __future__ import annotations
3
+
4
+ import json
5
+ from urllib.parse import urljoin, urlparse, urlunparse, urlencode
6
+
7
+ import httpx
8
+ from websockets.asyncio.client import connect as ws_connect
9
+
10
+
11
+ class HostedAvatarClient:
12
+ def __init__(self, api_key: str, base_url: str = "https://bevyra.ai"):
13
+ if not api_key:
14
+ raise ValueError("A BeVyra API key is required")
15
+ parsed = urlparse(base_url)
16
+ if parsed.scheme != "https" and parsed.hostname not in ("localhost", "127.0.0.1"):
17
+ raise ValueError("Hosted rendering requires HTTPS")
18
+ self.api_key = api_key
19
+ self.base_url = base_url.rstrip("/") + "/"
20
+
21
+ async def connect(self, avatar: str, aspect_ratio: str = "portrait") -> "HostedAvatarSession":
22
+ if aspect_ratio not in ("portrait", "landscape", "square"):
23
+ raise ValueError("Invalid aspect ratio")
24
+ async with httpx.AsyncClient(timeout=30) as client:
25
+ response = await client.post(urljoin(self.base_url, "/api/sdk/v1/render-sessions"),
26
+ headers={"Authorization": f"Bearer {self.api_key}",
27
+ "X-BeVyra-SDK-Version": "1.0.12"}, json={"avatarId": avatar})
28
+ if not response.is_success:
29
+ try:
30
+ error = response.json().get("error", {})
31
+ message = error.get("message") if isinstance(error, dict) else str(error)
32
+ except ValueError:
33
+ message = response.text
34
+ raise RuntimeError(message or f"Hosted render refused ({response.status_code})")
35
+ grant = response.json()["session"]
36
+ url = urlparse(urljoin(self.base_url, grant["streamPath"]))
37
+ scheme = "wss" if url.scheme == "https" else "ws"
38
+ address = urlunparse(url._replace(scheme=scheme, query=urlencode({"ticket": grant["ticket"]})))
39
+ socket = await ws_connect(address, max_size=1024 * 1024)
40
+ try:
41
+ await socket.send(json.dumps({"type": "session.setup", "protocol": 1, "avatar": avatar,
42
+ "aspectRatio": aspect_ratio,
43
+ "audio": {"encoding": "pcm_s16le", "sampleRate": 16000, "channels": 1}}))
44
+ ready = json.loads(await socket.recv())
45
+ if ready.get("type") != "session.ready":
46
+ raise RuntimeError(ready.get("message", "Hosted renderer did not become ready"))
47
+ return HostedAvatarSession(socket, self.base_url, ready)
48
+ except BaseException:
49
+ await socket.close()
50
+ raise
51
+
52
+
53
+ class HostedAvatarSession:
54
+ def __init__(self, socket, base_url: str, ready: dict):
55
+ self.socket = socket
56
+ self.base_url = base_url
57
+ self.ready = ready
58
+ self.whep_url = urljoin(base_url, ready["whepUrl"])
59
+ self.generation = 0
60
+ self.clause_id = 0
61
+ self.turn_id = 0
62
+
63
+ async def send_audio(self, pcm16: bytes, boundary: str = "terminal") -> int:
64
+ """Send one 16 kHz mono PCM16 hop, including internal pauses."""
65
+ if boundary not in ("terminal", "vad") or len(pcm16) % 2 or not pcm16:
66
+ raise ValueError("Expected nonempty PCM16 bytes and terminal or vad boundary")
67
+ self.clause_id += 1
68
+ ident = self.clause_id
69
+ await self.socket.send(json.dumps({"type": "clause.start", "clauseId": ident,
70
+ "turnId": self.turn_id, "generation": self.generation,
71
+ "sampleCount": len(pcm16) // 2, "boundary": boundary}))
72
+ for offset in range(0, len(pcm16), 16000):
73
+ await self.socket.send(pcm16[offset:offset + 16000])
74
+ await self.socket.send(json.dumps({"type": "clause.end", "clauseId": ident}))
75
+ if boundary == "terminal":
76
+ self.turn_id += 1
77
+ return ident
78
+
79
+ async def events(self):
80
+ async for message in self.socket:
81
+ if isinstance(message, str):
82
+ yield json.loads(message)
83
+
84
+ async def offer(self, sdp: str) -> tuple[str, str | None]:
85
+ """Exchange a WebRTC offer; use the returned SDP for the media track."""
86
+ async with httpx.AsyncClient(timeout=20) as client:
87
+ response = await client.post(self.whep_url,
88
+ headers={"Content-Type": "application/sdp"}, content=sdp)
89
+ response.raise_for_status()
90
+ return response.text, response.headers.get("Location")
91
+
92
+ async def interrupt(self) -> None:
93
+ self.generation += 1
94
+ self.turn_id += 1
95
+ await self.socket.send(json.dumps({"type": "session.interrupt", "generation": self.generation}))
96
+
97
+ async def close(self) -> None:
98
+ await self.socket.send(json.dumps({"type": "session.end"}))
99
+ await self.socket.close()
100
+
101
+ async def __aenter__(self):
102
+ return self
103
+
104
+ async def __aexit__(self, *_exc):
105
+ await self.close()
106
+
107
+
108
+ __all__ = ["HostedAvatarClient", "HostedAvatarSession"]
@@ -0,0 +1,8 @@
1
+ Metadata-Version: 2.1
2
+ Name: bevyra-hosted
3
+ Version: 0.1.0
4
+ Summary: BeVyra hosted avatar API client
5
+ Requires-Python: >=3.10
6
+ Requires-Dist: httpx <1,>=0.27
7
+ Requires-Dist: websockets <17,>=13
8
+
@@ -0,0 +1,5 @@
1
+ bevyra_hosted/__init__.py,sha256=JufPWMIicLhJOr2p8ELtsIAYxo2asL9qTtd_lJoeHFE,4915
2
+ bevyra_hosted-0.1.0.dist-info/METADATA,sha256=qyWFJoMNfllagB2LZOxJPvi4FX5oNjybBnILIPACgKk,189
3
+ bevyra_hosted-0.1.0.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
4
+ bevyra_hosted-0.1.0.dist-info/top_level.txt,sha256=Cfi1AaXQmlz2B_NRsdRyCvIx6CZepOXCiOEhVY_Y3vY,14
5
+ bevyra_hosted-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: bdist_wheel (0.41.2)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1 @@
1
+ bevyra_hosted