# Reactor

> Reactor is the developer platform for real-time world models: stream live, steerable AI video over WebRTC from JavaScript, React, or Python. Hosted world and video models, one wire protocol — open a session, send commands, receive video in under a second.

Fastest path to a working app: `npx create-reactor-app my-app --model=<slug>` scaffolds a complete app with secure auth wired up. Each model's connect slug and typed SDK package are listed under Models below — take slugs from there or the model's own pages, never from memory. Auth: exchange an API key (`rk_...`) for a JWT via `POST https://api.reactor.inc/tokens` from your server — never ship the API key to the client. Append `.md` to any docs URL for clean Markdown; the full corpus is at https://docs.reactor.inc/llms-full.txt and a docs-search MCP server runs at https://docs.reactor.inc/mcp.

## Common starting points

- [Quickstart](https://docs.reactor.inc/quickstart.md): Scaffold a ready-to-run app with create-reactor-app, or wire up the SDK by hand
- [Overview](https://docs.reactor.inc/overview.md): What Reactor is and the 20-line version of an app in JS, React, and Python
- [Authentication](https://docs.reactor.inc/authentication.md): API keys, the /tokens exchange, and production auth patterns
- [Model catalog](https://docs.reactor.inc/model-api-reference/overview.md): Every hosted model with its commands, events, and behavior
- [Using the SDK](https://docs.reactor.inc/sdk-reference/using-the-sdk.md): Connect to any model and send commands, receive video, and handle events

## Models

Each model has four pages: overview (quick start), schema (every command and event), prompt guide, and tutorial. Overviews linked below; substitute `schema.md`, `prompt-guide.md`, or `tutorial.md` for the other pages.

- [HappyOyster](https://docs.reactor.inc/model-api-reference/happy-oyster/overview.md): Permanent explorable worlds built from a prompt — play them with held controls or direct them with text. Slugs `reactor/happy-oyster-adventure` / `reactor/happy-oyster-director` (the typed SDK picks one via `mode: "adventure" | "directing"`), npm `@reactor-models/happy-oyster`
- [LingBot World 2](https://docs.reactor.inc/model-api-reference/lingbot-world-2/overview.md): Image-anchored navigable world model with WASD driving, camera moves, and live prompt steering. Slug `reactor/lingbot-world-2`, npm `@reactor-models/lingbot-world-2`
- [LingBot](https://docs.reactor.inc/model-api-reference/lingbot/overview.md): Real-time navigable video with WASD movement, look controls, and live prompt steering. Slug `reactor/lingbot`, npm `@reactor-models/lingbot`
- [X2](https://docs.reactor.inc/model-api-reference/x2/overview.md): Live reference-guided video transformation with character, clothing, style, and trajectory control. Slug `xmax/x2`, npm `@reactor-models/x2`
- [Helios](https://docs.reactor.inc/model-api-reference/helios/overview.md): Interactive real-time video generation with chunked autoregressive diffusion and image-to-video. Slug `reactor/helios`, npm `@reactor-models/helios`
- [LongLive-2.0](https://docs.reactor.inc/model-api-reference/longlive-v2/overview.md): Autoregressive multi-shot video — direct a sequence with soft shots and hard cuts, live or scheduled. Slug `reactor/longlive-v2`, npm `@reactor-models/longlive-v2`
- [SANA-Streaming](https://docs.reactor.inc/model-api-reference/sana-streaming/overview.md): Real-time streaming video editing — text-driven edits to uploaded clips or a live webcam feed. Slug `reactor/sana-streaming`, npm `@reactor-models/sana-streaming`
- [LTX](https://docs.reactor.inc/model-api-reference/ltx/overview.md): A photo and a script become a lip-synced video-and-audio take of that person speaking, generated live. Slug `reactor/ltx2`, npm `@reactor-models/ltx2`

## SDK reference

- [Typed model SDKs](https://docs.reactor.inc/sdk-reference/typed-model-sdk.md): Per-model classes and React wrappers (`@reactor-models/*`) over the base SDK
- [Reactor class (JS)](https://docs.reactor.inc/sdk-reference/reactor-class.md): The base JavaScript class for connecting to any model
- [React components](https://docs.reactor.inc/sdk-reference/react-components.md): ReactorProvider, ReactorView, and friends
- [React hooks](https://docs.reactor.inc/sdk-reference/react-hooks.md): useReactor and the hook API
- [Reactor class (Python)](https://docs.reactor.inc/sdk-reference/python/reactor.md): The async Python client
- [Python tracks](https://docs.reactor.inc/sdk-reference/python/track.md): The Python object form of a named media track
- [SDK types](https://docs.reactor.inc/sdk-reference/types.md): Shared TypeScript types
- [SDK events](https://docs.reactor.inc/sdk-reference/events.md): Every event the JS SDK emits

## Concepts

- [Models](https://docs.reactor.inc/models/overview.md): The shared wire protocol every model speaks, and typed SDK vs base class
- [Sessions](https://docs.reactor.inc/concepts/sessions.md): Session lifecycle, connection states, and multi-client sessions
- [Commands and messages](https://docs.reactor.inc/concepts/commands-and-messages.md): Two-way communication between your app and a model
- [Tracks](https://docs.reactor.inc/concepts/tracks.md): Named media tracks for video and audio
- [File uploads](https://docs.reactor.inc/concepts/file-uploads.md): Upload files and pass them to model commands
- [Recordings](https://docs.reactor.inc/concepts/recordings.md): Save clips of a live session and download them as MP4
- [Frame metadata](https://docs.reactor.inc/concepts/frame-metadata.md): Tag an outbound video frame and read the tag back on what the model produces from it

## Deploying your own model

- [Deploy overview](https://docs.reactor.inc/deploy/overview.md): Write a Python model with the Reactor Runtime and stream it to any client
- [CLI installation](https://docs.reactor.inc/deploy/platform/installation.md): Install the reactor CLI
- [CLI commands](https://docs.reactor.inc/deploy/cli-reference/commands.md): Every reactor CLI command grouped by parent command, linking into the per-command reference
- [Model development](https://docs.reactor.inc/deploy/development/overview.md): Model anatomy, run loop, lifecycle, events, state, media input, and weights — start here and follow its links

## Resources

- [Billing](https://docs.reactor.inc/resources/billing.md): How sessions are charged and how to track usage
- [Rate limits](https://docs.reactor.inc/resources/rate-limits.md): Concurrent session limits and token TTL
- [FAQ](https://docs.reactor.inc/resources/faq.md): Frequently asked questions
- [Support](https://docs.reactor.inc/resources/support.md): How to get help

## Optional

- [Content moderation](https://docs.reactor.inc/resources/content-moderation.md): What the platform filters and why
- [Changelog](https://docs.reactor.inc/changelog/overview.md): Release notes for SDKs and models