infinite-livestream README

The project's README from github.com/reactor-team/infinite-livestream. As one markdown file: README.md.

infinite-livestream

An end-to-end, chat-driven, never-ending AI video broadcast. Viewers type !prompt <idea> in Twitch or YouTube chat; an LLM expands each idea into a styled sequence of scenes; the fast-h3 model generates them as 768p video clips with synchronized audio; and the stream goes out over RTMP as one uninterrupted broadcast.

Two halves, one contract:

Folder What it is Runs on
fast-h3/ The model: a queue of prompt-driven clip generations with explicit/auto playback. A reactor CLI workspace. Reactor Runtime, 8x B200
streaming-client/ The client: chat → prompt upsampling → scene groups → the model's queue → paced RTMP output. reactor-sdk (Python), any box with ffmpeg

They meet on the wire: fast-h3/fasth3_types.py is the client-facing contract (commands, messages, tracks), and the streaming client speaks exactly that — through reactor-sdk, the Reactor Python SDK, which carries the session, the commands and messages, and the WebRTC media tracks.

The model

The video generator is FastH3 Preview v1: MiniMax-H3 (35B) distilled by the FastVideo project down to four transformer forwards with 90% sparse video attention, generating video and audio jointly from text. The model, the distillation, and the inference engine this repo serves are FastVideo's work — fast-h3/ wraps them in a queue-and-playout contract for the Reactor platform.

Quickstart

Serve the model (locally with reactor run from fast-h3/, or deploy it), then:

cd streaming-client
pip install -r requirements.txt     # ffmpeg must be on PATH for RTMP
cp .env.example .env                # keys, style, sink, chat channel
python main.py --local --sink noop  # dry run against a local runtime
python main.py                      # everything from .env

Documentation

License

The code is Apache License 2.0 — see LICENSE and NOTICE. The model weights are licensed separately under the MiniMax H3 Community License, inherited from the base model MiniMaxAI/MiniMax-H3.

infinite-livestream (reactor-team/infinite-livestream)

Searching Database…

What is this?An end-to-end, chat-driven, never-ending AI video broadcast: viewers type !prompt in Twitch or YouTube chat, an LLM expands the idea into a styled scene, the FastH3 model renders it as a 768p clip with synced audio, and it goes out continuously over RTMP.
Is this one app or two separate pieces?It is split into two halves: fast-h3/ runs the video generation model and needs the Reactor Runtime with 8x B200 GPUs, while streaming-client/ handles chat ingestion, prompt upsampling and paced RTMP output and only needs Python with reactor-sdk plus ffmpeg. They communicate through a shared contract defined in fasth3types.py.
How do I get it running?First serve the model, either locally with `reactor run` from fast-h3/ or by deploying it, then start the streaming-client which pulls chat commands, queues scene generations against the model, and pushes the paced output over RTMP.
What hardware do I need to run the model?The model expects the Reactor Runtime on 8x B200 GPUs to serve FastH3 Preview v1; the streaming client itself just needs Python with reactor-sdk and any box with ffmpeg installed.
Can I run the model on a regular single-GPU box?The model is built around the Reactor Runtime with 8x B200 GPUs, and the detailed weights layout, GPU/CUDA prerequisites and performance profile are documented separately in fast-h3/README.md rather than in this top-level README.
What is FastH3 Preview v1?It is MiniMax-H3 (35B parameters) distilled by the FastVideo project down to four transformer forwards with 90% sparse video attention, generating video and audio jointly directly from text.
Where do the stream's prompts actually come from?Viewers type !prompt directly in Twitch or YouTube chat, and an LLM expands each idea into a styled sequence of scenes before it is queued for generation.
Is there a minimal client to test the model queue directly?Yes, fast-h3/client/README.md documents a minimal reactor-sdk smoke-test client that walks through the raw queue contract once, without the full streaming pipeline.
Size
0.8 MB
Stars
240
Updated
CommitAug 30
Age
1mo
Commits · 90 Days