Models

Model catalog, CLI commands, runtime readiness, and how to choose a model for a run.

On this page

Use This Page

Use this page when you need to pick a model, check whether it can run on your machine, or understand what a support label means. The table names below are catalog groups, not separate commands. For day-to-day use, start from the CLI:

GoalCommand
List known model ids and aliasesworldfoundry-eval zoo models --json
View one model manifestworldfoundry-eval zoo model-show --model-id <model-id> --include-manifest --json
Check local checkpoints, credentials, and asset blockersworldfoundry-eval zoo model-download --model-id <model-id> --check-local --json
List runtime runnersworldfoundry-eval models runtime-runners --json

Run inference

With a prepared requests.jsonl, generate artifacts via the pipeline runner:

worldfoundry-eval evaluate \
  --mode model \
  --model-id <model-id> \
  --model-runner worldfoundry:pipeline \
  --model-manifest-dir worldfoundry/data/models/catalog \
  --requests-path tmp/requests.jsonl \
  --output-dir tmp/model_eval \
  --metric artifact_count \
  --required-artifact video \
  --json

For the full inference flow (environment, checkpoints, Studio), see the Inference guide.

Output files

FilePurpose
run_manifest.jsonRun id, model, benchmark metadata, timestamps, output paths
results.jsonlPer-sample status, artifacts, timing
metrics/summary.jsonAggregated metrics
scorecard.jsonLeaderboard eligibility and blocking reasons

When a run fails

  1. zoo model-show --include-manifest — integration status and blockers
  2. zoo model-download --check-local — checkpoint, credential, and asset readiness
  3. Cross-check the benchmark page for required datasets, API keys, and generated-output layout
  4. Cross-check the model registry below for runner evidence on that model id

Choosing a Model

Before spending GPU time, answer these questions in order:

QuestionWhat to check
Is the model known to WorldFoundry?It appears in worldfoundry-eval zoo models --json and has a stable model_id.
Can this repo route the model?The manifest resolves through a runner and pipeline binding. runtime_ported means the route exists, but real checkpoint/API/simulator parity may still be pending.
Can it run in your environment?zoo model-download --check-local, models assets, and the benchmark page report required checkpoints, API keys, datasets, or simulators.
Is it benchmark-ready for your task?The model has evidence for the specific benchmark or artifact type you plan to run. Video, 3D, world-action, and VLA tasks require different evidence.

Reading Catalog Rows

ColumnMeaning
FamilyPublic project or provider family. Variants may still have separate manifests.
CapabilityWhat the model can produce or predict in WorldFoundry terms.
Runtimelocal, official repo, subprocess, hosted API, or mixed.
Evidence targetThe next useful proof before a stronger public claim.

Current coverage summary

WorldFoundry tracks model support at the manifest, runner, and benchmark-evidence levels. Use this summary to find the right model group first, then inspect the exact model id with zoo model-show.

Catalog directoryEntriesWhat it coversRepresentative ids
worldfoundry/data/models/catalog/video/48Video, audio, and multimodal generation catalog (merged from video_open and video_pipeline_runner). Includes open-source provenance records and pipeline-bound runtime integrations.wan2.1, hunyuanvideo, animatediff, zeroscope, step-video-t2v, sana, vmem, krea-realtime-video.
worldfoundry/data/models/catalog/world_models/69Interactive world-model and simulator catalog (merged from world_models and world_pipeline_runner).matrix-game-2, lingbot-world, hunyuanworld-voyager, diamond, dino-wm, leworldmodel, starwm, irasim.
worldfoundry/data/models/catalog/three_d_four_d/473D/4D generation, reconstruction, point-cloud, geometry, scene-representation, and perception-prior records. Status mix: 25 integrated, 10 runtime_ported, 10 blocked, 2 planned; most resolve through pipeline bindings.flashworld, fantasyworld, dust3r, monst3r, splatt3r, pixelsplat, vggt-omega, dvlt.
worldfoundry/data/models/catalog/vla_va_wam/42VLA, VA, WAM, robot-policy, and embodied-action records. All entries expose runner targets and bindings; most are runtime_ported, while full policy/runtime claims remain checkpoint and simulator gated.openvla, openpi, pi0-fast, smolvla, xvla, eo1, tdmpc, vqbet, wall-oss, act.

Model source registry

This registry combines worldfoundry/data/models/catalog manifests with official paper, project-page, and source links confirmed for this docs surface. When a separate paper, project page, or code repository is not published, the closest official model card, source page, or project URL is used.

Open video models

Upstream video-generation families and in-tree runtime or metadata records. Support levels vary: some ids have verified local generation paths, others are checkpoint-gated wrappers, hosted/API-shaped entries, or provenance-only. Use catalog readiness and zoo model-show before treating a row as runnable.

Wan2.1 (wan2.1)
Wan2.2 (wan2.2)
HunyuanVideo (hunyuanvideo)
LTX-Video (ltx-video)
LTX-2.x (ltx-2.x)
CogVideoX (cogvideox)
Open-Sora (open-sora)
Open-Sora-Plan (open-sora-plan)
Mochi-1 (mochi-1)
Allegro (allegro)
EasyAnimate (easyanimate)
VideoCrafter (videocrafter)
DynamiCrafter (dynamicrafter)
I2VGen-XL (i2vgen-xl)
ModelScopeT2V (modelscope-t2v)
HunyuanVideo 1.5 (hunyuanvideo-1.5)
SkyReels-V2 (skyreels-v2)
MAGI-1 (magi-1)
FramePack (framepack)
Step-Video-T2V (step-video-t2v)
Open-MAGVIT2 (open-magvit2)
Show-o (show-o)
AnimateDiff (animatediff)
ZeroScope (zeroscope)

World models

Interactive, camera-controlled, navigation, driving, and long-horizon simulation systems, including provenance or metadata-only rows. Capability tags are contract hints: action-controlled models should preserve action traces, camera-controlled models should expose camera metadata, and long-horizon systems need artifact naming that preserves sequence order.

Cosmos Predict 2.5 (cosmos-predict-2.5)
Cosmos Transfer 2.5 (cosmos-transfer-2.5)
DreamDojo (dreamdojo)
Matrix-Game 1.0 (matrix-game-1)
Matrix-Game 2.0 (matrix-game-2)
Matrix-Game 3.0 (matrix-game-3)
LingBot-World (lingbot-world)
HunyuanWorld 1.0 (hunyuanworld-1)
HunyuanWorld-Voyager (hunyuanworld-voyager)
HY-WorldPlay (hy-worldplay)
HunyuanWorld-Mirror (hunyuanworld-mirror)
HY-World 2.0 (hy-world-2.0)
InSpatio-WorldFM (worldfm)
Infinite-World (infinite-world)
WorldCam (worldcam)
CameraCtrl (cameractrl)
MotionCtrl (motionctrl)
ViewCrafter (viewcrafter)
IRASim (irasim)
Pandora (pandora)

3D and 4D models

3D/4D generation, reconstruction, point-cloud, geometry, and perception-prior models, including provenance or metadata-only rows. Prefer entries with explicit geometry, camera, or asset metadata when you need measurable 3D outputs; some rows still need a port plan before they are runnable in WorldFoundry.

MVDiffusion (mvdiffusion)
4D-GS (4d-gs)
MonST3R (monst3r)
Shape of Motion (shape-of-motion)
FlashWorld (flashworld)
FantasyWorld (fantasyworld)
WonderWorld (wonderworld)
NeoVerse (neoverse)
ReCamMaster (recammaster)
Lyra (lyra)
Stable Virtual Camera (stable-virtual-camera)
Splatt3R (splatt3r)
pixelSplat (pixelsplat)

VLA, VA, and WAM models

These models are evaluated through behavior, not image quality alone. A usable run needs observations, language or task instructions, action outputs, simulator or dataset context, and a success signal that can be mapped into normalized metrics.

openvla is the checkpoint-verified embodied-action baseline in this group. MolmoAct2 also has an in-tree WorldFoundry pipeline/runtime surface for DROID and bimanual YAM action-trace contracts, with checkpoint-backed GPU parity still pending. The former generic LeRobot policy-zoo surface is retired; policies from lerobot/src/lerobot/policies are now tracked as concrete algorithms with their own upstream sources, such as ACT, Diffusion Policy, TD-MPC, VQ-BeT, pi0/pi0.5/pi0-FAST, SmolVLA, GR00T, X-VLA, WALL-OSS, EO-1, MolmoAct2, Multi-task DiT, Gaussian Actor, and RTC. Most VLA/VA/WAM rows are currently runtime_ported: they have a WorldFoundry route contract, but task support is still bounded by checkpoint, simulator, and real inference evidence.

OpenVLA (openvla)
OpenPI (openpi)
MolmoAct2 (molmoact2)
TD-MPC (tdmpc)
VQ-BeT (vqbet)
SmolVLA (smolvla)
X-VLA (xvla)
EO-1 (eo1)
Being-H0.5 (being-h05)
NVIDIA DreamZero (dreamzero)
NVIDIA GR00T (gr00t)
StarVLA (starvla)
LingBot-VA (lingbot-va)
Latent Action Pretraining (lapa)
Octo (octo)
RT-1 (rt-1)
Diffusion Policy (diffusion-policy)
Action Chunking Transformer (act)
RoboFlamingo (roboflamingo)