Welcome to WorldFoundry

WorldFoundry

Toward a general infrastructure for world intelligence

One workflow

  • Discovery, inference, inspection, and evaluation under one operational definition
  • TUI, CLI, Studio, Python, and MCP share the same request and artifact contracts
  • Inspect manifests, needs, and blockers before allocating GPUs or downloading weights
  • Durable artifacts support later review, rescoring, and evidence reuse
  • Python API reference generated from live source signatures and docstrings

Breadth with clear boundaries

  • 275 model entries and 74 browsable benchmarks, with explicit readiness signals
  • Native upstream runtimes across video, 3D/4D, interactive worlds, and embodied stacks
  • Benchmarks score outputs without taking ownership of model loading
  • Generation and scoring can run in separate environments when required
  • Scorecards capture provenance, coverage, blockers, and what each result can support
  • CLI stays the source of truth for integration state and next actions

WorldFoundry is open-source infrastructure for world intelligence. World intelligence is not a single generation task: a system has to infer structured state from observations, predict how that state evolves, express the consequences in task-specific outputs, and use those predictions during interaction. Video generators, neural scene representations, 4D models, and embodied policies each cover part of this problem.

Discovery, runtime and asset preparation, inference, artifact inspection, and benchmark evidence share one workflow across those families — without forcing them into one representation, task, or metric.

A first run

After the Quickstart environment is sourced, generate one inspectable artifact for matrix-game-2:

bash scripts/inference/prepare_model_infer.sh matrix-game-2 --download
worldfoundry-eval run matrix-game-2-universal-action-validation \
  --pipeline.task-profile official-universal-image

That run justifies one claim: this configuration produced an inspectable artifact. It does not mean a benchmark completed. Everyday commands use worldfoundry-eval run. Layers and inventory are in Design.

Operational definition

Visual plausibility measures observation quality. It is not sufficient evidence of world modeling. A photorealistic video can still lose object identity, violate dynamics, or ignore an intervention.

We therefore treat a generative world model as a learned, history- and control-conditioned latent dynamical system. It infers and maintains a persistent environmental state, evolves that state under endogenous dynamics and external interventions, and assimilates new observations so later predictions remain accountable to what just happened.

Operational definition of a world model: state inference, forward simulation, and interactive response, closed by observation feedback

Three coupled operations make the definition usable:

  1. State inference — estimate a task-relevant latent state from the interaction history.
  2. Forward simulation — predict how that state evolves under autonomous dynamics, physical constraints, and actions.
  3. Interactive response — produce distinct, coherent futures under alternative interventions, then fold observed outcomes back into the maintained state.

A compact, modality-agnostic form is

zt∼q(zt∣ht),zt+1∼p(zt+1∣zt,ct),o^t+1∼g(ot+1∣zt+1).z_t \sim q(z_t \mid h_t),\qquad z_{t+1} \sim p(z_{t+1} \mid z_t, c_t),\qquad \hat{o}_{t+1} \sim g(o_{t+1} \mid z_{t+1}).

Here hth_t is the observation–control history, ctc_t is an action or intervention (including a null control), ztz_t is the inferred environment state, and o^t+1\hat{o}_{t+1} is a visual, geometric, or task-specific output. The formulation is functional rather than architectural: ztz_t may be recurrent, object-centric, geometric, token-based, or otherwise structured.

From the same inferred state, controls with different environmental consequences should induce distinct but coherent rollouts. Factors outside the intervention should continue to follow the same conditional dynamics. New observations must update the state used thereafter.

Capability progression

WorldFoundry does not assign every model a single discrete level. It records a capability profile: which functions a system actually supports, and whether those functions are coupled.

Capability progression from perceptual grounding through the world-model spine of persistent state, dynamics, and closed-loop interaction, with controllable transformation as an orthogonal capability
Foundational

Perceptual grounding

Interpret, reconstruct, or synthesize observations. This is the perceptual basis for state inference — not yet a persistent model of the environment.

World-model spine

persistent state → dynamics prediction → interactive feedback

  1. Persistent state

    Infer and maintain structured environmental state across observations, identities, geometry, and partial views.

  2. Dynamics

    Predict coherent transitions under endogenous processes, actions, and interventions, so earlier events constrain later outcomes.

  3. Closed-loop interaction

    Act, observe, and update the same state. Feedback revises what the model believes before the next prediction.

Orthogonal

Controllable transformation

Selectively edit represented content while leaving the rest intact. Manipulation can strengthen any stage, but it is not by itself dynamics or interaction.

Perceptual grounding supplies observational evidence. The world-model spine is the coupling that matters: persistent state, intervention-conditioned dynamics, and feedback-driven updating. Controllable transformation can sit beside any of those stages — editing a couch color or deleting a shelf does not, by itself, prove that the system can roll the scene forward or close an interaction loop.

Foundation models and generative world models

The taxonomy is functional, not a ranking of visual quality.

Foundation generative models learn visual, geometric, or spatiotemporal priors for synthesis, reconstruction, and controllable manipulation. They may be excellent at appearance, short-horizon coherence, or selective edits. They do not integrate state, dynamics, and feedback into a complete world-modeling loop.

Generative world models do integrate that loop. Intervention effects persist across subsequent transitions, and new observations revise the state that governs later predictions. Higher fidelity, broader prompting, or larger scale does not by itself promote a system from the first class to the second.

That is why WorldFoundry separates catalog inclusion, runnable inference, inspectable artifacts, and benchmark-eligible evidence. A convincing demo can still be only perceptual grounding. The model catalog and benchmark hub show current coverage and readiness. Catalog inclusion is not a runnable runtime. A demo is not benchmark evidence. An ingested score is not official leaderboard parity. Those states stay separate, with provenance.

Why a shared workflow

WorldFoundry is most useful when work spans more than one model, benchmark, or execution surface. The technical report calls this commensurability without homogenization: heterogeneous systems stay inspectable under shared operational and evidential contracts, without being forced into a single representation, task, or metric.

That is why the shared workflow exists:

  • One operational vocabulary. Stable model and benchmark IDs, plus request, result, artifact, manifest, and scorecard records, replace repository nicknames and handwritten paths. You can ask whether a model was only cataloged or actually executed, which checkpoint and runtime ran, whether samples were covered, and whether a score was normalized, officially computed, or validated for a leaderboard.
  • Shared glue. Environment bootstrap, checkpoint lookup, input shaping, output naming, job records, previews, and metric aggregation stay shared. Model-specific code lives in pipelines and operators; benchmark-specific code stays in runners and metrics.
  • Reusable artifacts. Generated output is not trapped in a UI session. The same artifacts can be inspected, rescored, converted, compared, or audited later without loading the model again.
  • Evidence beyond a command. The same command can change meaning after a checkpoint, package, dataset, or evaluator changes. Ledgers, identities, blockers, and scorecards record both what ran and what the result is allowed to claim.
  • Multiple interfaces, one backend. TUI, CLI, Studio, Python, and MCP reuse the same catalogs and contracts. The interface can change; the run identity and durable outputs do not.

This fits teams that maintain or compare several world-model families, separate generation from evaluation, reuse expensive artifacts, or need stable machine-readable discovery for people and agents. The more models, benchmarks, machines, and reviewers you have, the more those contracts repay their setup cost.

WorldFoundry unifies world-model discovery, inference, inspection, and evaluation

Acknowledgements

WorldFoundry integrates and adapts upstream world-model, video-generation, perception, reconstruction, embodied-action, and evaluation projects. Each catalog entry keeps its own source and license metadata.

Infrastructure foundations

  • FastVideoUnified inference and post-training framework for accelerated video generation.
  • OpenWorldLibUnified codebase for advanced world models.
  • VLA Evaluation HarnessFramework for evaluating VLA models on robot simulation benchmarks.