gitwtfhub

wtf is worldreasonbench?

unix-ai-lab/worldreasonbench — explained in plain English

Analysis updated 2026-05-18

14PythonAudience · researcherComplexity · 2/5Setup · moderate

TL;DR

A benchmark that tests whether AI video generators understand real world cause and effect, not just visual realism.

Mindmap

mindmap
  root((WorldReasonBench))
    What it does
      Tests video reasoning
      Checks world consistency
      Scores generators
    Tech stack
      Python
      Hugging Face
    Use cases
      Evaluate models
      Compare leaderboard
      Train reward models
    Audience
      Researchers

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

Evaluate a video generation model's physical and logical reasoning ability

REASON 2

Compare closed source and open source video generators on a public leaderboard

REASON 3

Train or test reward models using the companion preference dataset

REASON 4

Study which reasoning categories current video generators struggle with

What's in the stack?

Python

How it stacks up

unix-ai-lab/worldreasonbench0c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audienceresearcherdeveloperresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires downloading the dataset from Hugging Face and a video generation model to evaluate.

Wtf does this do

WorldReasonBench is a research benchmark that tests whether AI video generators can genuinely reason about how the world changes over time, rather than simply producing visually convincing footage. The central question it asks is: given a starting scene and an action, does the generated video show a future state that is physically, socially, logically, and informationally consistent with reality? The benchmark contains 436 carefully selected test cases with structured question-and-answer annotations covering four reasoning dimensions and 22 subcategories, including world knowledge, human-centric behavior, logic reasoning, and information-based inference. Alongside the main benchmark, the project also releases WorldRewardBench, a companion preference benchmark with approximately 6,000 expert-annotated pairs across over 1,400 videos, designed to evaluate reward models used to score video quality. Evaluation uses two scoring approaches. The first, called Score_PR, combines question-answer accuracy with a dynamic-phase penalty, and the README reports that this metric reproduces human preference rankings with very low rank displacement. The second, S(v), is a weighted score across reasoning quality, temporal consistency, and visual aesthetics. Results from 11 evaluated generators are published in a leaderboard in the README, separated into closed-source and open-source models. The benchmark is positioned as a research contribution to the question of whether video generation systems are becoming true world simulators. It is written in Python, and the dataset is available on Hugging Face. The full README is longer than what was provided.

Yoink these prompts

Prompt 1
Help me run WorldReasonBench against my video generation model
Prompt 2
Explain the Score_PR and S(v) metrics used in WorldReasonBench
Prompt 3
Show me how to download and load the WorldReasonBench dataset from Hugging Face
Prompt 4
Summarize the four reasoning dimensions this benchmark tests

Frequently asked questions

wtf is worldreasonbench?

A benchmark that tests whether AI video generators understand real world cause and effect, not just visual realism.

What language is worldreasonbench written in?

Mainly Python. The stack also includes Python.

How hard is worldreasonbench to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is worldreasonbench for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

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