Skip to content

examples: add visko-orbis-distilled dev example (Phase 4) #263

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
willemhelmet wants to merge 3 commits into from
Closed

examples: add visko-orbis-distilled dev example (Phase 4) #263

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
efde557
examples: add visko-orbis-distilled dev example
willemhelmet Aug 27, 2026
cbff8eb
examples(visko): track vendored typed SDK build output
willemhelmet Aug 27, 2026
41fcd6c
examples: index visko-orbis-distilled in the examples README
willemhelmet Aug 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 11 additions & 10 deletions examples/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,17 @@

Self-contained, runnable Next.js apps built on `@reactor-team/js-sdk` and the typed per-model packages. These are the same templates that `npx create-reactor-app` scaffolds — each folder here can be cloned, installed, and run independently.

| Example | Model | Highlights |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`happy-oyster/`](./happy-oyster) | [`@reactor-models/happy-oyster`](https://www.npmjs.com/package/@reactor-models/happy-oyster) | Interactive world model. Build a world from a prompt (or attach a permanent one), then travel it live: **Adventure** worlds you drive with WASD, **Director** worlds you steer with text `instruct` + pause/rewind. Mode-fixed sessions, authoritative `world_state` snapshot. |
| [`helios/`](./helios) | [`@reactor-models/helios`](https://www.npmjs.com/package/@reactor-models/helios) | Continuous prompt-driven video generation. Curated text and image scenes, mid-stream prompt hot-swap via `setPrompt`, atomic `setConditioning({ prompt, image })` for image-to-video, snap-clip recording, design tokens from `@reactor-team/ui`. |
| [`lingbot/`](./lingbot) | [`@reactor-models/lingbot`](https://www.npmjs.com/package/@reactor-models/lingbot) | Interactive world model. Pick a starting image, drive the scene with WASD, layer in curated dynamic events (rain, fog, …) as live prompt swaps, snap-clip recording. |
| [`lingbot-world-2/`](./lingbot-world-2) | [`@reactor-models/lingbot-world-2`](https://www.npmjs.com/package/@reactor-models/lingbot-world-2) | Interactive world model you drive like a game. Two-axis WASD driving, per-latent `set_camera_pose` motion (mouse-look, roll, orbit, jump arcs, crouch dips), hold-key world events, a layered prompt workbench with live editor + inspector, attn-window / KV-cache knobs. |
| [`longlive-v2/`](./longlive-v2) | [`@reactor-models/longlive-v2`](https://www.npmjs.com/package/@reactor-models/longlive-v2) | Multi-shot **director's storyboard**. Compose shots (`set_shot`) and cuts (`scene_cut`) on a chunk timeline, schedule beats with `schedule_shot` / `schedule_scene_cut`, then direct live. Surfaces the per-scene 48-chunk budget and how cuts extend length. Snap-clip recording. |
| [`ltx2/`](./ltx2) | [`@reactor-models/ltx2`](https://www.npmjs.com/package/@reactor-models/ltx2) | Streaming **talking-head avatar**. Upload a face and a script; the model generates voice and lip-synced video together and streams both. The take in flight is frozen, but the session stays editable: mid-run edits are accepted and queue for the next take, surfaced from `state_update.queued_changes`. Server-authoritative `valid_commands`, crop-before-upload, measured TTFF. |
| [`sana-streaming/`](./sana-streaming) | [`@reactor-models/sana-streaming`](https://www.npmjs.com/package/@reactor-models/sana-streaming) | Streaming **V2V editor**. Live webcam transform via manual `camera` publish, file-clip editing with side-by-side compare, mid-stream re-prompting, seed control, snap-clip recording. |
| [`x2/`](./x2) | [`@reactor-team/js-sdk`](https://www.npmjs.com/package/@reactor-team/js-sdk) (typed client vendored in-app) | Streaming **V2V editor** on XMAX X2. Webcam, file-clip, or still-image sources on one `source` track, side-by-side compare, mid-stream re-prompting, reference-image conditioning via `uploadFile`, drag-to-steer pointer on the output, keep-backlog toggle, snap-clip recording. |
| Example | Model | Highlights |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`happy-oyster/`](./happy-oyster) | [`@reactor-models/happy-oyster`](https://www.npmjs.com/package/@reactor-models/happy-oyster) | Interactive world model. Build a world from a prompt (or attach a permanent one), then travel it live: **Adventure** worlds you drive with WASD, **Director** worlds you steer with text `instruct` + pause/rewind. Mode-fixed sessions, authoritative `world_state` snapshot. |
| [`helios/`](./helios) | [`@reactor-models/helios`](https://www.npmjs.com/package/@reactor-models/helios) | Continuous prompt-driven video generation. Curated text and image scenes, mid-stream prompt hot-swap via `setPrompt`, atomic `setConditioning({ prompt, image })` for image-to-video, snap-clip recording, design tokens from `@reactor-team/ui`. |
| [`lingbot/`](./lingbot) | [`@reactor-models/lingbot`](https://www.npmjs.com/package/@reactor-models/lingbot) | Interactive world model. Pick a starting image, drive the scene with WASD, layer in curated dynamic events (rain, fog, …) as live prompt swaps, snap-clip recording. |
| [`lingbot-world-2/`](./lingbot-world-2) | [`@reactor-models/lingbot-world-2`](https://www.npmjs.com/package/@reactor-models/lingbot-world-2) | Interactive world model you drive like a game. Two-axis WASD driving, per-latent `set_camera_pose` motion (mouse-look, roll, orbit, jump arcs, crouch dips), hold-key world events, a layered prompt workbench with live editor + inspector, attn-window / KV-cache knobs. |
| [`longlive-v2/`](./longlive-v2) | [`@reactor-models/longlive-v2`](https://www.npmjs.com/package/@reactor-models/longlive-v2) | Multi-shot **director's storyboard**. Compose shots (`set_shot`) and cuts (`scene_cut`) on a chunk timeline, schedule beats with `schedule_shot` / `schedule_scene_cut`, then direct live. Surfaces the per-scene 48-chunk budget and how cuts extend length. Snap-clip recording. |
| [`ltx2/`](./ltx2) | [`@reactor-models/ltx2`](https://www.npmjs.com/package/@reactor-models/ltx2) | Streaming **talking-head avatar**. Upload a face and a script; the model generates voice and lip-synced video together and streams both. The take in flight is frozen, but the session stays editable: mid-run edits are accepted and queue for the next take, surfaced from `state_update.queued_changes`. Server-authoritative `valid_commands`, crop-before-upload, measured TTFF. |
| [`sana-streaming/`](./sana-streaming) | [`@reactor-models/sana-streaming`](https://www.npmjs.com/package/@reactor-models/sana-streaming) | Streaming **V2V editor**. Live webcam transform via manual `camera` publish, file-clip editing with side-by-side compare, mid-stream re-prompting, seed control, snap-clip recording. |
| [`visko-orbis-distilled/`](./visko-orbis-distilled) | [`@reactor-models/visko-orbis-distilled`](https://www.npmjs.com/package/@reactor-models/visko-orbis-distilled) (vendored pre-publish) | Continuous **steerable video generation** (Visko Orbis, Distilled tier). Text-to-video and image-anchored starts, **per-chunk live prompt morphing**, resolution picker from `available_resolutions`, seed, audio on/off + muted `main_audio` outlet, snap-clip recording. |
| [`x2/`](./x2) | [`@reactor-team/js-sdk`](https://www.npmjs.com/package/@reactor-team/js-sdk) (typed client vendored in-app) | Streaming **V2V editor** on XMAX X2. Webcam, file-clip, or still-image sources on one `source` track, side-by-side compare, mid-stream re-prompting, reference-image conditioning via `uploadFile`, drag-to-steer pointer on the output, keep-backlog toggle, snap-clip recording. |

## Running an example

Expand Down
1 change: 1 addition & 0 deletions examples/visko-orbis-distilled/.env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
REACTOR_API_KEY=rk_your_api_key_here
15 changes: 15 additions & 0 deletions examples/visko-orbis-distilled/.gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
node_modules
.next
.env
.env.local
*.log
.DS_Store
*.tsbuildinfo

# The vendored typed SDK ships only its built output (dist/ + package.json +
# README) — exactly what `npm i @reactor-models/visko-orbis-distilled` would
# lay down once the package is published. The repo-root .gitignore ignores
# `dist/` everywhere (it exists for the library build), which would otherwise
# strip the vendored package's only payload and make a fresh clone unrunnable.
# Re-include it here so the PR is self-contained. See vendor/README.md.
!vendor/**/dist/
Loading
Loading