reactor-sdk 0.1.0__py3-none-any.whl

reactor_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: reactor-sdk
+Version: 0.1.0
+Summary: Python SDK for Reactor - Real-time AI video streaming
+Project-URL: Homepage, https://reactor.inc
+Project-URL: Documentation, https://docs.reactor.inc
+Project-URL: Repository, https://github.com/reactor-team/py-sdk
+Author-email: Reactor Technologies <support@reactor.inc>
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: aiortc>=1.9.0
+Requires-Dist: av>=12.0.0
+Requires-Dist: numpy>=1.24.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Reactor Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/reactor-sdk)](https://pypi.org/project/reactor-sdk/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/reactor-sdk)](https://pypi.org/project/reactor-sdk/)
+[![build](https://img.shields.io/github/actions/workflow/status/reactor-team/py-sdk/ci.yml?branch=main)](https://github.com/reactor-team/py-sdk/actions)
+[![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
+
+Python SDK for Reactor - Real-time AI video streaming platform.
+
+## Installation
+
+```bash
+pip install reactor-sdk
+```
+
+## Quick Start
+
+```python
+import asyncio
+from reactor_sdk import Reactor, ReactorStatus
+
+async def main():
+    # Create a Reactor instance with your API key
+    reactor = Reactor(
+        model_name="my-model",
+        api_key="REACTOR_API_KEY",  # SDK automatically fetches JWT token
+    )
+    
+    # Use decorators for clean event handling
+    @reactor.on_frame
+    def handle_frame(frame):
+        print(f"Received frame: {frame.shape}")
+    
+    @reactor.on_message
+    def handle_message(msg):
+        print(f"Message: {msg}")
+    
+    @reactor.on_status(ReactorStatus.READY)
+    def handle_ready(status):
+        print("Connected and ready!")
+    
+    @reactor.on_error
+    def handle_error(error):
+        print(f"Error: {error}")
+    
+    # Connect to the model (JWT token is fetched automatically)
+    await reactor.connect()
+    
+    # Send commands
+    await reactor.send_command("setParameter", {"value": 0.5})
+    
+    # Keep running
+    try:
+        while reactor.get_status() == ReactorStatus.READY:
+            await asyncio.sleep(0.1)
+    finally:
+        await reactor.disconnect()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Features
+
+- **WebRTC video streaming** via aiortc
+- **Event-driven API** matching the JavaScript SDK
+- **Frame callbacks** for single-frame access
+- **Video input** support for sending video to models
+- **Local development** mode for testing
+- **Full type hints** for IDE support
+
+## API Reference
+
+### Reactor
+
+The main class for connecting to Reactor models.
+
+```python
+from reactor_sdk import Reactor
+
+# Production usage with API key
+reactor = Reactor(
+    model_name="my-model",
+    api_key="REACTOR_API_KEY",  # SDK fetches JWT automatically
+)
+
+# Local development (no API key needed)
+reactor = Reactor(
+    model_name="my-model",
+    local=True,
+)
+```
+
+The `Reactor` type can also be used for type annotations:
+
+```python
+from reactor_sdk import Reactor
+
+def process_reactor(reactor: Reactor) -> None:
+    # reactor has full type hints for all methods
+    pass
+```
+
+#### Methods
+
+- `await reactor.connect()` - Connect to the model (fetches JWT automatically if API key provided)
+- `await reactor.disconnect(recoverable: bool = False)` - Disconnect
+- `await reactor.reconnect()` - Reconnect to existing session
+- `await reactor.send_command(command: str, data: dict)` - Send a command
+- `await reactor.publish_track(track: MediaStreamTrack)` - Send video to model
+- `await reactor.unpublish_track()` - Stop sending video
+- `reactor.get_status()` - Get current status
+- `reactor.get_session_id()` - Get session ID
+- `reactor.set_frame_callback(callback)` - Set frame callback
+
+#### Decorators
+
+Use decorators for clean event handling:
+
+```python
+@reactor.on_frame
+def handle_frame(frame):
+    """Called for each video frame (numpy array H,W,3)."""
+    pass
+
+@reactor.on_message
+def handle_message(message):
+    """Called for each message from the model."""
+    pass
+
+@reactor.on_status
+def handle_any_status(status):
+    """Called for all status changes."""
+    pass
+
+@reactor.on_status(ReactorStatus.READY)
+def handle_ready(status):
+    """Called only when status becomes READY."""
+    pass
+
+@reactor.on_status([ReactorStatus.READY, ReactorStatus.CONNECTING])
+def handle_active(status):
+    """Called when status is READY or CONNECTING."""
+    pass
+
+@reactor.on_error
+def handle_error(error):
+    """Called when an error occurs."""
+    pass
+
+@reactor.on_stream
+def handle_stream(track):
+    """Called when video stream/track changes."""
+    pass
+```
+
+#### Events (alternative to decorators)
+
+- `status_changed` - Status changed (disconnected, connecting, ready)
+- `session_id_changed` - Session ID changed
+- `new_message` - Message received from model
+- `stream_changed` - Video stream changed
+- `error` - Error occurred
+
+## Examples
+
+See the `examples/` directory for complete examples:
+
+- `pygame_app/` - Pygame application with dynamic UI controls
+- `rtmp_app/` - Stream Reactor video to RTMP servers (Twitch, YouTube, etc.)
+
+## License
+
+MIT License - Copyright (c) 2025 Reactor Technologies, Inc.

reactor_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+reactor_sdk/__init__.py,sha256=ArlbpKS9m9Lnk_qPzQCKr9cLnbo2QafhqbtVZvPhSM4,1141
+reactor_sdk/interface.py,sha256=KZepoLJgIpw5DUUud-fgSf_37NwIRVLBwaH3zECMEWI,6356
+reactor_sdk/py.typed,sha256=SHDQjboaDzPjXhn4h87KOQ0MfRZ2aE-z-5GO9p6eUsY,67
+reactor_sdk/reactor.py,sha256=YWlj6LtWQ8AqJEkRQmcXGyXB85pwoGpAfMMXeRKj8TA,25346
+reactor_sdk/types.py,sha256=Z1rryNF8d4OlXpCgB9qWQSCUBRzZq6bkJ_b7uvEInfc,6486
+reactor_sdk/coordinator/__init__.py,sha256=J4rU6pLpaK2F9B8WwJ5Bq1vZuA4GDtTs00x94dWv6Xs,331
+reactor_sdk/coordinator/client.py,sha256=_W5yWL_hpq6NyKeMj-1LtE-oZBhTerg1OQbdvbsMAzw,12210
+reactor_sdk/coordinator/local_client.py,sha256=X0VFp4msC25Zvp_zYnp7R1UWxE_qovSxcmkUx7Kc7GU,4986
+reactor_sdk/model/__init__.py,sha256=t9UUR34tfLEk_YvF7rZ2EGY0gL5I0JxnYUZP_khkrgk,200
+reactor_sdk/model/client.py,sha256=g0Ep_krVpYXaQV6yVQ7w2vDw2gpq3dNdxff9F8tpc-A,21907
+reactor_sdk/utils/__init__.py,sha256=bFoJC1xKWp0yJtFpe3m92713peW-hkY0lAFVk6TOGog,579
+reactor_sdk/utils/tokens.py,sha256=12ruVwM-G6IHB6E0wtwyP5l_SR5J1oR15-QHrcQfYMQ,1722
+reactor_sdk/utils/webrtc.py,sha256=8VOFy2z7yEJzv7qbY6032qECmxs5VeFbC1LYLVunEvo,8268
+reactor_sdk-0.1.0.dist-info/METADATA,sha256=Y20MW84oa0BoGTK2MtPLWVVkqhsHES7I-DbmLPf2uQI,5828
+reactor_sdk-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+reactor_sdk-0.1.0.dist-info/licenses/LICENSE,sha256=CkDoTv8jJieKzduDY7CaXPOki4G_w6Y6FispatCeSeE,1083
+reactor_sdk-0.1.0.dist-info/RECORD,,

reactor_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

reactor_sdk-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Reactor Technologies, 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.