whatisgithub

What is worldreasonbench?

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

Analysis updated 2026-05-18

14PythonAudience · researcherComplexity · 2/5Setup · moderate

In one sentence

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

Train or test reward models using the companion preference dataset

USE CASE 4

Study which reasoning categories current video generators struggle with

What is it built with?

Python

How does it compare?

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 get it running?

Difficulty · moderate Time to first run · 1h+

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

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.