Practical overview
When it fits
Use the repository when you want to work directly with Genie model code and run its documented training stages in a local Python environment.
Who it is for
- Researchers exploring generative interactive environments learned from video.
- Python and PyTorch developers who want to train or customize Genie model components.
Documented uses
- Train a VideoTokenizer that converts video into discrete tokens.
- Train LatentAction and Dynamics components after training the VideoTokenizer.
- Experiment with configuration-driven training of a Genie-style model.
Requirements & limits
The project is a public GitHub repository with an MIT license.
- The project is explicitly an unofficial implementation of Genie.
- The README specifies Python 3.11+ and PyTorch 2.0+ and uses a LightningCLI interface.
- Training LatentAction and Dynamics depends on a fully trained VideoTokenizer.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Train the VideoTokenizer
Start training the Genie VideoTokenizer with a repository configuration file.
Before you start
- Python 3.11 or later and PyTorch 2.0 or later.
- Install dependencies with
pip install -r requirements.txt. - A configuration file; example configuration files are provided in the
configfolder.
Steps
Choose or prepare a configuration file for the VideoTokenizer.
Run the command below.
python tokenizer.py train -config
Expected outcome
The LightningCLI command starts the VideoTokenizer training workflow using the selected configuration.
Guide limitations
- This command covers VideoTokenizer training only; the README does not provide a dataset-preparation procedure.
- Training LatentAction and Dynamics is a separate stage and relies on a fully trained VideoTokenizer.
Train LatentAction and Dynamics
Use the repository’s CLI to train the LatentAction and Dynamics components after preparing the VideoTokenizer stage.
Before you start
- Python 3.11 or later and PyTorch 2.0 or later.
- Install dependencies with
pip install -r requirements.txt. - A fully trained VideoTokenizer and a configuration file; example configuration files are provided in the
configfolder.
Steps
Prepare a configuration file for the Genie training command.
Run the command below.
python genie.py train -config
Expected outcome
The command starts training for the LatentAction and Dynamics models through LightningCLI.
Guide limitations
- The README states that this stage relies on a fully trained VideoTokenizer.
- The command does not document video-data preparation or a post-training inference procedure.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- myscience/open-genie · Official homepage title · retained in its source language

