World models · interactive-world-model · image-to-video · camera-control

Hunyuan Game Craft

tencent

In-tree Hunyuan GameCraft pipeline is registered; official inference uses the HYGameCraft conda profile and torchrun dispatch.

Runner verified独立环境hunyuan-game-craft

构建运行命令

选择仓库中已记录的 variant,然后复制对应的准备、检查或运行命令。

worldfoundry.pipeline
任务interactive-world-model
环境HYGameCraft
设备CUDA 12.4
worldfoundry-eval evaluate \
  --mode model \
  --model-id hunyuan-game-craft \
  --model-runner worldfoundry:pipeline \
  --model-manifest-dir worldfoundry/data/models/catalog \
  --requests-path tmp/requests.jsonl \
  --output-dir tmp/model_eval/hunyuan-game-craft \
  --metric artifact_count \
  --json
01

兼容性与版本

由 Manifest 生成

集成状态
runtime ported
Runner 证据
verified
环境
HYGameCraft
Python
3.10
CUDA
CUDA 12.4
PyTorch
torch==2.5.1
源码 revision
Checkpoint revision
022caa8698ea7134cd7823875757e7322fe894d6
Runtime profile
hunyuan-game-craft
Pipeline binding
hunyuan-game-craft
Runner
worldfoundry.pipeline
Pipeline target
worldfoundry.pipelines.hunyuan_world.pipeline_hunyuan_game_craft:HunyuanGameCraftPipeline
Backend stage
official_in_tree_runtime
Runtime 状态
official_torchrun_contract
Driver 状态
compatible
环境类型
独立环境
02

安装环境

环境解析器会读取已记录 profile,并选择此处显示的统一或独立环境。

bash scripts/setup/model_env_install.sh --model hunyuan-game-craft
依赖版本约束 27
  • torch==2.5.1
  • torchvision==0.20.0
  • torchaudio==2.5.1
  • accelerate==1.9.0
  • av==15.0.0
  • decord==0.6.0
  • diffusers==0.34.0
  • einops==0.8.1
  • huggingface-hub==0.34.3
  • imageio==2.37.0
  • imageio-ffmpeg==0.6.0
  • loguru==0.7.3
  • numpy==2.1.2
  • nvidia-ml-py==12.575.51
  • nvitop==1.5.2
  • opencv-python-headless==4.12.0.88
  • packaging==25.0
  • pillow==11.0.0
  • protobuf==6.31.1
  • psutil==7.0.0
  • pyyaml==6.0.2
  • safetensors==0.5.3
  • sentencepiece==0.2.0
  • tokenizers==0.21.4
  • tqdm==4.67.1
  • transformers==4.54.1
  • triton==3.1.0
Conda 依赖 5
  • python=3.10
  • pip
  • ffmpeg
  • ninja
  • cuda-toolkit=12.4
03

Checkpoint 与资产

分配算力前先做本地检查;gated、private 与 license 字段直接来自 checkpoint manifest。

worldfoundry-eval zoo model-download --model-id hunyuan-game-craft --check-local --json
tencent/Hunyuan-GameCraft-1.0
Revision
022caa8698ea7134cd7823875757e7322fe894d6
License
Gated
Private
04

运行与输出

生成的命令通过共享 evaluation 边界运行,并持久保存结果 manifest 与 artifact。

worldfoundry-eval evaluate \
  --mode model \
  --model-id hunyuan-game-craft \
  --model-runner worldfoundry:pipeline \
  --model-manifest-dir worldfoundry/data/models/catalog \
  --requests-path tmp/requests.jsonl \
  --output-dir tmp/model_eval/hunyuan-game-craft \
  --metric artifact_count \
  --json

输入契约

字段已记录契约
promptRequired
imageRequired
videoOptional
actionscamera_path, navigation_action

Artifact 契约

Artifact 类型文件名 / 路径
generated_worldhunyuan-game-craft.mp4
05

证据与来源

Catalog 集成、原生 demo parity 与 runner parity 是三条独立记录。

集成状态
runtime ported
Runner 证据
verified
原生 Demo 证据
未记录
验证 Imports
torch, torchvision, cv2, imageio, loguru, flash_attn