Practical overview
When it fits
Use it when you want a code-level starting point for experiments with action-conditioned video generation and can work with PyTorch tensors and an implementation identified as work in progress.
Who it is for
- Researchers experimenting with video-and-action world-model training.
- Developers prototyping action-conditioned future-frame generation or interactive world-model demos.
Documented uses
- Train a model using video and corresponding action IDs.
- Generate future frames from an initial video frame.
- Explore an interactive sequence in which action IDs guide successive frames.
Requirements & limits
The repository is public and lists an MIT license. Its README provides installation via pip.
- This is a developer library, not a hosted generation app; the documented workflow is code-based.
- The README's example uses synthetic tensors and does not describe preparing a real video-and-action dataset.
- Interactive generation prompts for action IDs at successive frames.
- The repository labels the implementation work in progress.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the library and follow the documented generation example
Set up the Python package and inspect the documented training and frame-generation calls.
Before you start
- Python environment with PyTorch available.
- The README's sample inputs are PyTorch tensors; they are synthetic examples, not a real dataset.
Steps
Install the package with the command below.
pip install genie2-pytorchImport
torchandGenie2, then create a model using the documented example parameters.Create video and action tensors, call the model to obtain a loss, and call
loss.backward().Pass the initial frame to
genie.generatewith a frame count to request generated video.
Expected outcome
The README demonstrates a training-loss call and a generated video tensor containing the initial frame and requested future frames.
Guide limitations
- The repository describes the implementation as work in progress.
- The example uses synthetic tensors and does not document real-data preparation or evaluation.
Use the interactive generation example
Follow the documented pattern for prompting for action IDs as generated frames advance.
Before you start
- Python environment with PyTorch and
genie2-pytorchinstalled. - A
Genie2instance and video tensor shaped as in the README example.
Steps
Create the model and example video and action tensors as shown in the README.
Run the model call and backpropagation shown in the example.
Call
genie.generatewithinteractive=Trueand aninit_actionvalue.Enter the next action ID or IDs when prompted for each subsequent time frame.
Expected outcome
The example returns generated video and action values while prompting for actions during sequence generation.
Guide limitations
- The interactive instructions are an example, not a documented integration with a game or simulator.
- The implementation is labeled work in progress.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- lucidrains/genie2-pytorch · Official homepage title · retained in its source language

