Reactor Runtime
A Python framework for building real-time, interactive video models. Write your ML code — Reactor handles networking, media transport, and client connections.
Installation
pip install reactor-runtime
Quick Example
from dataclasses import dataclass
from reactor_runtime.interface import Output, Video, ReactorPipeline, InputState, InputField
@dataclass
class MyOutput(Output):
video: Video
@dataclass
class MyState(InputState):
prompt: str = InputField(default="a sunny meadow")
class MyModel(ReactorPipeline):
state: MyState
def load(self, config):
self.pipe = load_my_model(config["checkpoint"])
def inference(self):
while True:
frame = self.pipe.forward(prompt=self.state.prompt)
yield MyOutput(video=frame)
Implement inference() as a generator that yields frames. Clients can update self.state mid-generation — no restart, no re-queue.
Key Features
- Real-time streaming — frames delivered over WebRTC as they're generated
- Live interaction — clients change inputs mid-generation via typed, validated state
- No transport code — no WebRTC, WebSocket, or video encoding to manage
- Scaffold & run — the Go
reactorCLI gives youreactor init/reactor run; the Python runtime ships its ownreactor-runtimescript for standalone use
Standalone usage (no Go CLI)
The runtime CLI is installed as reactor-runtime so it never shadows the Go
reactor binary. If you only use the Python runtime:
pip install reactor-runtime
reactor-runtime init my-model
cd my-model
python -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
reactor-runtime run
The Go reactor CLI delegates to this same reactor-runtime script under the
hood; both reactor run (Go) and reactor-runtime run (standalone) execute the
same Python entry point.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file reactor_runtime-2.10.1.tar.gz.
File metadata
- Download URL: reactor_runtime-2.10.1.tar.gz
- Upload date:
- Size: 263.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c25fbc6f04b1c1ca555cba3557083cc78924bac714ce322e0254537d54d37fd8
|
|
| MD5 |
51c4a38b0b6cce8da661e2cd4026e74f
|
|
| BLAKE2b-256 |
6c4215e359863e54da721c3ec333d2004b3cb15a46575d9a248283f25ed6c277
|
File details
Details for the file reactor_runtime-2.10.1-py3-none-any.whl.
File metadata
- Download URL: reactor_runtime-2.10.1-py3-none-any.whl
- Upload date:
- Size: 329.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
18fe5e004492e03d5eaf83cccbf590d88018e91622453d575c030417894f2de9
|
|
| MD5 |
0e65ec8c0a43466c0d060d3cbf29b221
|
|
| BLAKE2b-256 |
7e4c9c71bde15c5c01eda9652b5cee3da831e50c8804eec30fb64fde89b8dec8
|
