Skip to content
jzr99Public

About

[CVPR 2026] Mesh4D: 4D Mesh Reconstruction and Tracking from Monocular Video

Resources

Stars

123 stars

Watchers

2 watching

Forks

Repository files navigation

Mesh4D: 4D Mesh Reconstruction and Tracking from Monocular Video

🔥 News

  • Jan 9, 2026: 🤗 We release the first version of Mesh4D!
  • Nov 5, 2026: 🤗 We release the MeshBench Bechmark and visualization code!

⚙️ Setup

Install Environment via Anaconda (Recommended)

conda create -n mesh4d python=3.10.18
conda activate mesh4d

We test our model with Python 3.10 and PyTorch 2.5.1+cu124.

pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 --index-url https://download.pytorch.org/whl/cu124
pip install -r requirements.txt

cd hy3dpaint/custom_rasterizer
pip install -e .
cd ../..
cd hy3dpaint/DifferentiableRenderer
bash compile_mesh_painter.sh
cd ../..

wget https://github.com/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth -P hy3dpaint/ckpt

cd hy3dshape
python ./setup_im2mesh.py build_ext --inplace
cd ..

Download model checkpoint

mkdir ckpt
gdown 1e9YGQAuFr5BDN2--srDEMnoULb4ZP5sx -O ./ckpt/ # deformation vae
gdown 1jeNwiP9-B1uyKvk3_yBN7Y9-D7YQxBc5 -O ./ckpt/ # denoiser

😈 Inference

We provide some preprocessed in-the-wild image sequences from Consistent4D dataset ./DATA/ for inference:

cd hy3dshape
python infer.py

For other in-the-wild videos, you need to first segment foreground object out and save it as a sequence of RGBA images with white background.

😸 Evaluation

See the benchmark guide for the benchmark download folder, checksum-verified extraction, clip definitions, and rendered-image evaluation. The benchmark contains 40 animated GLBs and 50 evaluation clips from 39 objects; the six-frame and sixteen-frame protocols use 50 and 48 clips, respectively.

After obtaining the benchmark archives and rendering your predictions, run from the repository root:

python -m pip install -r benchmark/requirements.txt
python benchmark/download.py --archive-dir /path/to/archives --skip-download
python benchmark/evaluate.py \
  --benchmark-root data/mesh4d_benchmark \
  --pred-root /path/to/prediction_renders \
  --frames 6 --output-dir benchmark/results/mesh4d_6

The evaluator reports PSNR, SSIM, LPIPS, and CLIP image similarity. It checks all required frames before scoring and supports the original Mesh4D render layout. Optional historical I3D scoring and alternate filename layouts are documented in the guide. Archive publication to Drive has not yet been verified; local archives can already be verified and extracted with the command above.

🌠 Visualization

Render animated Mesh4D GLBs as four-view PNG sequences with Blender 4.0, then assemble a GIF or MP4 preview:

blender --background --python-exit-code 1 --python visualization/render.py -- \
  --input /path/to/combined_gen_mtl.glb \
  --output-dir visualization/results/example
python visualization/preview.py \
  --input-dir visualization/results/example \
  --output visualization/results/example.gif --fps 24

CPU rendering is the default; use --device CUDA or --device OPTIX for GPU rendering. See the visualization guide for frame selection, turntables, clay shading, benchmark cameras, and MP4 output.

Acknowledgements

We have used codes from other great research work, including Hunyuan3D-2.1, TripoSG, Motion2VecSets, Consistent4D, and Diffusion4D. We sincerely thank the authors for their awesome work!

🔗 BibTeX

If you find Mesh4D useful for your research and applications, please cite us using this BibTex:

@misc{jiang2026mesh4d,
      title={Mesh4D: 4D Mesh Reconstruction and Tracking from Monocular Video}, 
      author={Zeren Jiang and Chuanxia Zheng and Iro Laina and Diane Larlus and Andrea Vedaldi},
      year={2026},
      eprint={2601.05251},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2601.05251}, 
}

About

[CVPR 2026] Mesh4D: 4D Mesh Reconstruction and Tracking from Monocular Video

Resources

Stars

123 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages