README.md

metadata

license: other
license_name: multiple-licenses
license_link: LICENSE.md
datasets:
  - chris10/EgoForce
pipeline_tag: image-to-3d
tags:
  - egocentric-vision
  - hand-tracking
  - hand-pose-estimation

EgoForce: Forearm-Guided Camera-Space 3D Hand Pose from a Monocular Egocentric Camera

This repository contains EgoForce model assets and supporting files for egocentric hand and arm perception. Our trained checkpoints are _DATA/epoch_460.pth and _DATA/model_weights.pth. The repository also includes third-party assets used by the pipeline, a WiLoR-based 2D hand detector and MANO hand model files.

Repository contents

Path	Role	Provenance	License / notice
_DATA/detector.torchscript	2D hand bounding-box detector used in preprocessing	WiLoR detector	Third-party asset; see WiLoR notice below
_DATA/mano/*	MANO hand model files	Official MANO distribution	Third-party asset; see MANO notice below
_DATA/epoch_460.pth	EgoForce hand-arm detector	EgoForce	First-party project asset
_DATA/model_weights.pth	EgoForce model	EgoForce	First-party project asset

Important licensing note

No single license applies to every file in this repository.

• The repository metadata is set to license: other because the contents include third-party assets with different licensing terms.
• _DATA/detector.torchscript remains subject to the original WiLoR model license.
• _DATA/mano/* remains subject to the official MANO license.
• This repository does not grant any additional rights to those third-party assets.
• The detailed notice is in LICENSE.md.

Third-party notices

WiLoR detector

_DATA/detector.torchscript is the 2D hand bounding-box detector used by this repository. According to the official WiLoR repository, WiLoR models are released under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International license (CC BY-NC-ND 4.0).

Official sources:

• Project page: https://rolpotamias.github.io/WiLoR/
• Code and license notice: https://github.com/rolpotamias/WiLoR
• CVPR 2025 paper: https://openaccess.thecvf.com/content/CVPR2025/html/Potamias_WiLoR_End-to-end_3D_Hand_Localization_and_Reconstruction_in-the-wild_CVPR_2025_paper.html
• CC BY-NC-ND 4.0 summary: https://creativecommons.org/share-your-work/cclicenses/
• CC BY-NC-ND 4.0 legal code: https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode

MANO

_DATA/mano/* contains MANO hand model assets from the Max Planck MANO distribution. The official MANO license is a separate non-commercial research license.

Official sources:

• Project page: https://mano.is.tue.mpg.de/
• License terms: https://mano.is.tue.mpg.de/license.html
• MPI code page: https://is.mpg.de/code/embodied-hands

Required citations

If you use the WiLoR detector bundled in this repository, cite WiLoR:

@InProceedings{Potamias_2025_CVPR,
  author    = {Potamias, Rolandos Alexandros and Zhang, Jinglei and Deng, Jiankang and Zafeiriou, Stefanos},
  title     = {WiLoR: End-to-end 3D Hand Localization and Reconstruction in-the-wild},
  booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
  month     = {June},
  year      = {2025},
  pages     = {12242-12254}
}

If you use MANO assets or outputs parameterized by MANO, cite MANO:

@article{MANO:SIGGRAPHASIA:2017,
  title   = {Embodied Hands: Modeling and Capturing Hands and Bodies Together},
  author  = {Romero, Javier and Tzionas, Dimitrios and Black, Michael J.},
  journal = {ACM Transactions on Graphics, (Proc. SIGGRAPH Asia)},
  volume  = {36},
  number  = {6},
  series  = {245:1--245:17},
  month   = nov,
  year    = {2017}
}

Compliance note

This model card documents known upstream attribution and licensing obligations for transparency. It is not legal advice. Before public redistribution, verify that every bundled third-party file is hosted in a manner consistent with its original license terms.