hold

zc-alexfanMIT更新放缓

从单目视频里同时重建关节手和物体的三维姿态与形状,无需预扫描物体模板或手物交互训练数据,适合做手物交互建模与AR/VR研究。

[CVPR 2024✨Highlight] Official repository for HOLD, the first method that jointly reconstructs articulated hands and objects from monocular videos without assuming a pre-scanned object template and 3D hand-object training data.

暂无版本496star18fork同步于 2026-11-07 07:30 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/zc-alexfan/hold.git
cd hold; git submodule update --init --recursive
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

从单目视频联合重建手与物体的 3D 几何,无需预扫描物体模板

从单目视频里同时重建关节手和物体的三维姿态与形状,无需预扫描物体模板或手物交互训练数据,适合做手物交互建模与AR/VR研究。

核心能力

  • 无需预扫描物体模板,类别无关地重建新物体
  • 联合重建手与物体的动态交互几何
  • 提供体渲染框架重建手物交互
  • 支持单手与双手加物体的通用代码库
  • 提供交互式 viewer 查看重建结果

容易踩的坑

环境配置需按 docs/setup.md 操作,且需另行安装外部依赖才能处理自定义视频;需注册 HOLD 账号下载预训练权重与预处理数据;处理自定义视频前需先跑通官方预处理序列 hold_bottle1_itw

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

0 个版本

暂无 release 数据(可能没有发版,或尚未同步)。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    [CVPR'24 Highlight] HOLD: Category-agnostic 3D Reconstruction of Interacting Hands and Objects from Video

    [ Project Page ] [ Paper ] [ SupMat ] [ ArXiv ] [ Video ] [ HOLD Account ] [ ICCV'25 HOLD+ARCTIC Challenge ]

    Authors: Zicong Fan, Maria Parelli, Maria Eleni Kadoglou, Muhammed Kocabas, Xu Chen, Michael J. Black, Otmar Hilliges

    News

    ✨3DV 2026: Looking for hand scans data? PALM is a large-scale dataset containing high-quality 13k registered 3dMD hand scans of 263 subjects and 90k calibrated multiview RGB images. See PALM for details.

    🚀 Register a HOLD account here for news such as code release, downloads, and future updates!

    • 2025.07.04: Join our ICCV competition: Two hand + rigid object using HOLD on ARCTIC!
    • 2024.07.04: Join our ECCV competition: Two hand + rigid object using HOLD on ARCTIC!
    • 2024.07.04: HOLD beta is released!
    • 2024.04.04: HOLD is awarded CVPR highlight!
    • 2024.02.27: HOLD is accepted to CVPR'24! Working on code release!

    This is a repository for HOLD, a method that jointly reconstructs hands and objects from monocular videos without assuming a pre-scanned object template.

    HOLD can reconstruct 3D geometries of novel objects and hands:

    Potential directions from HOLD

    Features

    • Instructions to download in-the-wild videos from HOLD as well as preprocessed data
    • Scripts to preprocess and train on custom videos
    • A volumetric rendering framework to reconstruct dynamic hand-object interaction
    • A generalized codebase for single and two hand interaction with objects
    • A viewer to interact with the prediction
    • Code to evaluate and compare with HOLD in HO3D

    TODOs

    • Tips on good reconstruction
    • Clean the code further
    • Support arctic for two-hand + rigid object setting

    Documentation

    Getting started

    Get a copy of the code:

    git clone https://github.com/zc-alexfan/hold.git
    cd hold; git submodule update --init --recursive
    
    1. Setup environments

      • Follow the instructions here: docs/setup.md.
      • You may skip external dependencies for now.
    2. Train on a preprocessed sequence

      • Start with one of our preprocessed in-the-wild sequences, such as hold_bottle1_itw.
      • Familiarize yourself with the usage guidelines in docs/usage.md for this preprocessed sequence.
      • This will enable you to train, render HOLD, and experiment with our interactive viewer.
      • At this stage, you can also explore the HOLD code in the ./code directory.
    3. Set up external dependencies and process custom videos

      • After understanding the initial tools, set up the "external dependencies" as outlined in docs/setup.md.
      • Preprocess the images from the hold_bottle1_itw sequence by following the instructions in docs/custom.md.
      • Train on this sequence to learn how to build a custom dataset.
      • You can capture your own custom video and reconstruct it in 3D at this point.
      • Most preprocessing artifact files are documented in docs/data_doc.md, which you can use as a reference.
    4. Two-hand setting: Bimanual category-agnostic reconstruction

      • At this point, you can preprocess and train on a custom single-hand sequence.
      • Now you can take on the bimanual category-agnostic reconstruction challenge!
      • Following the instruction in docs/arctic.md to reconstruct two-hand manipulation of ARCTIC sequences.

    Official Citation

    @inproceedings{fan2024hold,
      title={{HOLD}: Category-agnostic 3d reconstruction of interacting hands and objects from video},
      author={Fan, Zicong and Parelli, Maria and Kadoglou, Maria Eleni and Kocabas, Muhammed and Chen, Xu and Black, Michael J and Hilliges, Otmar},
      booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},
      pages={494--504},
      year={2024}
    }
    

    Star History

    Star History Chart

    Contact

    For technical questions, please create an issue. For other questions, please contact the first author.

    Acknowledgments

    The authors would like to thank: Benjamin Pellkofer for IT/web support; Chen Guo, Egor Zakharov, Yao Feng, Artur Grigorev for insightful discussion; Yufei Ye for DiffHOI code release.

    Our code benefits a lot from Vid2Avatar, aitviewer, VolSDF, NeRF++ and SNARF. If you find our work useful, consider checking out their work.