whatisgithub

What is flow-world-models?

facebookresearch/flow-world-models — explained in plain English

Analysis updated 2026-05-18

51PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A research project from Meta FAIR and Inria that predicts multiple possible future video frames while keeping a strong visual representation of the scene.

Mindmap

mindmap
  root((FlowWM))
    What it does
      Predicts future video frames
      Models multiple outcomes
      Uses DINOv3 features
    Tech stack
      Python
      uv
      DINOv3
    Use cases
      Self driving perception research
      World model benchmarking
      Video prediction research
    Audience
      Researchers
      ML engineers

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

What do people build with it?

USE CASE 1

Research stochastic world models that predict several possible video futures at once.

USE CASE 2

Benchmark future frame prediction against real self driving footage using perception quality instead of pixels.

USE CASE 3

Generate a synthetic Bouncing Shapes dataset to study prediction accuracy and diversity precisely.

USE CASE 4

Reproduce the model architecture and training setup described in the accompanying research paper.

What is it built with?

PythonuvDINOv3PyTorch

How does it compare?

facebookresearch/flow-world-modelscortex-trading-systems/polymarket-copy-trading-bot-clob-aifacebookresearch/lamp
Stars515151
LanguagePythonPythonPython
Last pushed2026-06-18
MaintenanceMaintained
Setup difficultyhardhardhard
Complexity5/53/54/5
Audienceresearchergeneralresearcher

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires downloading the large Waymo Open Dataset and a GPU for training the model.

No license information was found in the README.

So what is it?

FlowWM is a research project from Meta's FAIR lab and Inria that works on teaching a computer to predict what happens next in a video. Existing approaches to this problem force a tradeoff. Some methods can imagine several different possible futures for the same starting point, but they work with a weaker internal representation of the scene. Other methods use a stronger representation of what is in each frame, but they can only predict one single, blurry average outcome instead of distinct possibilities. FlowWM tries to get both benefits at once by predicting multiple possible futures while still using a strong internal representation of the video called DINOv3 features. Alongside the model, the project introduces two benchmarks for testing how well a system predicts the future. The first, called FuturePerception, uses real self driving car footage from the Waymo Open Dataset. Instead of judging predictions by how close individual pixels look, it checks whether an object detector and a depth estimator still work correctly on the predicted future frames, which is a more meaningful test of whether the prediction actually makes sense. The second benchmark, called Bouncing Shapes, is a simple synthetic scene where a circle and a square bounce around a box in ways that could reasonably branch into more than one outcome, letting researchers measure accuracy and variety precisely since every correct answer is known in advance. The repository includes setup instructions using a tool called uv for installing dependencies, scripts to download and convert the Waymo dataset into the format the model expects, and a generator for creating the Bouncing Shapes dataset locally with configurable settings like clip length and resolution. A companion research paper describes the technical design choices in detail for readers who want to go deeper into how the method works.

Copy-paste prompts

Prompt 1
Help me install this project's dependencies using uv sync.
Prompt 2
Explain how to download and convert the Waymo Open Dataset for use with this world model.
Prompt 3
Walk me through generating the synthetic Bouncing Shapes dataset locally.
Prompt 4
Summarize how FlowWM combines flow matching with DINOv3 features to predict multiple futures.

Frequently asked questions

What is flow-world-models?

A research project from Meta FAIR and Inria that predicts multiple possible future video frames while keeping a strong visual representation of the scene.

What language is flow-world-models written in?

Mainly Python. The stack also includes Python, uv, DINOv3.

What license does flow-world-models use?

No license information was found in the README.

How hard is flow-world-models to set up?

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

Who is flow-world-models for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.