| --- |
| 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`](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: |
|
|
| ```bibtex |
| @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: |
|
|
| ```bibtex |
| @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. |
|
|
