gitwtfhub

wtf is orbis2?

lmb-freiburg/orbis2 — explained in plain English

Analysis updated 2026-05-18

14PythonAudience · researcherComplexity · 5/5LicenseSetup · hard

TL;DR

The official research code for Orbis 2, an AI model that generates long, steerable future driving video from past camera frames.

Mindmap

mindmap
  root((Orbis2))
    What it does
      Predicts future driving video
      Hierarchical L1/L2 model
      Steerable by trajectory
    Tech stack
      Python
      PyTorch
      Conda
      Hugging Face
    Use cases
      Generate driving rollouts
      Steer video with trajectories
      Reproduce paper results
    Audience
      Researchers
      ML engineers
      Autonomous driving teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Generate long horizon predicted driving video from an input clip using a hierarchical world model

REASON 2

Steer generated future driving footage with a specific speed, yaw rate, or 2D trajectory

REASON 3

Reproduce the experiments and rollouts described in the Orbis 2 research paper

REASON 4

Study a two-tier autoregressive video prediction architecture for driving scenes

What's in the stack?

PythonPyTorchCondaHugging Face

How it stacks up

lmb-freiburg/orbis20c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity5/54/54/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires a GPU, a Conda environment, and downloading separate pretrained checkpoints from Hugging Face.

Use, modify, and redistribute the code freely, including commercially, as long as you keep the copyright notice.

Wtf does this do

Orbis2 is the official code release for a research paper from the University of Freiburg that presents a driving world model, an AI system trained to generate realistic future video of what a car's camera would see next, based on past video frames it has already seen. It is designed for long stretches of predicted driving footage, not just a few frames ahead. The model works in two layers. A first component looks at video sampled at a low frame rate to build a rough, long range sense of what is likely to happen further into the future. A second component then uses that rough context together with recent high frame rate frames to generate the next frames one at a time, filling in fine detail as it goes. On top of this, the model can be steered: you can tell it to follow a specific driving speed and turning rate, or hand it a two dimensional path and have it generate video that follows that trajectory. Using it requires setting up a Python environment through Conda, then downloading pretrained model weights and configuration files from a separate Hugging Face repository. Once those pieces are in place, a single script rolls the model forward from an existing input video, optionally guided by a trajectory file that steers where the generated future frames go. A faster, distilled version of one of the two model components is available for quicker inference at some cost to quality, and several command line options control things like how many future steps to generate, which device handles decoding, and whether to compile the model for speed. This is a research artifact meant to accompany a published paper rather than a polished consumer tool: it assumes familiarity with running Python machine learning code, GPUs, and command line tools. It requires a GPU to run at a reasonable speed. All of the code in the repository is released under the MIT license, so it can be freely reused, modified, and built upon, including commercially.

Yoink these prompts

Prompt 1
Help me set up the Conda environment and download the Orbis2 checkpoints from Hugging Face
Prompt 2
Explain how Orbis2's L1 and L2 predictors work together to generate future driving video
Prompt 3
Show me how to run rollout_demo_v2.py with a custom trajectory file for steering
Prompt 4
Walk me through using the distilled model config to speed up Orbis2 inference

Frequently asked questions

wtf is orbis2?

The official research code for Orbis 2, an AI model that generates long, steerable future driving video from past camera frames.

What language is orbis2 written in?

Mainly Python. The stack also includes Python, PyTorch, Conda.

What license does orbis2 use?

Use, modify, and redistribute the code freely, including commercially, as long as you keep the copyright notice.

How hard is orbis2 to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is orbis2 for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.