Improve metadata and pipeline tag
#1
by nielsr HF Staff - opened
README.md
CHANGED
|
@@ -1,69 +1,44 @@
|
|
| 1 |
---
|
| 2 |
-
license: other
|
| 3 |
-
license_name: multiple-licenses
|
| 4 |
-
license_link: LICENSE.md
|
| 5 |
datasets:
|
| 6 |
- chris10/EgoForce
|
| 7 |
-
|
|
|
|
| 8 |
tags:
|
| 9 |
- egocentric-vision
|
| 10 |
- hand-tracking
|
| 11 |
- hand-pose-estimation
|
| 12 |
-
- arxiv:2605.12498
|
| 13 |
---
|
| 14 |
|
| 15 |
# EgoForce: Forearm-Guided Camera-Space 3D Hand Pose from a Monocular Egocentric Camera
|
| 16 |
-
[Project Page](https://dfki-av.github.io/EgoForce) | [Paper](https://arxiv.org/pdf/2605.12498) | [HF Paper](https://huggingface.co/papers/2605.12498) | [Code](https://github.com/dfki-av/EgoForce) | [Demo](https://huggingface.co/spaces/chris10/EgoForce)
|
| 17 |
|
|
|
|
| 18 |
|
| 19 |
-
|
| 20 |
|
| 21 |
## Repository contents
|
| 22 |
|
|
|
|
|
|
|
| 23 |
| Path | Role | Provenance | License / notice |
|
| 24 |
| --- | --- | --- | --- |
|
| 25 |
-
| `_DATA/detector.torchscript` | 2D hand bounding-box detector
|
| 26 |
| `_DATA/mano/*` | MANO hand model files | Official MANO distribution | Third-party asset; see MANO notice below |
|
| 27 |
| `_DATA/epoch_460.pth` | EgoForce hand-arm detector | EgoForce | First-party project asset |
|
| 28 |
| `_DATA/model_weights.pth` | EgoForce model | EgoForce | First-party project asset |
|
| 29 |
|
| 30 |
## Important licensing note
|
| 31 |
|
| 32 |
-
No single license applies to every file in this repository.
|
| 33 |
-
|
| 34 |
-
- The repository metadata is set to `license: other` because the contents include third-party assets with different licensing terms.
|
| 35 |
-
- `_DATA/detector.torchscript` remains subject to the original WiLoR model license.
|
| 36 |
-
- `_DATA/mano/*` remains subject to the official MANO license.
|
| 37 |
-
- This repository does not grant any additional rights to those third-party assets.
|
| 38 |
-
- The detailed notice is in [`LICENSE.md`](LICENSE.md).
|
| 39 |
-
|
| 40 |
-
## Third-party notices
|
| 41 |
-
|
| 42 |
-
### WiLoR detector
|
| 43 |
-
|
| 44 |
-
`_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).
|
| 45 |
-
|
| 46 |
-
Official sources:
|
| 47 |
-
|
| 48 |
-
- Project page: <https://rolpotamias.github.io/WiLoR/>
|
| 49 |
-
- Code and license notice: <https://github.com/rolpotamias/WiLoR>
|
| 50 |
-
- 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>
|
| 51 |
-
- CC BY-NC-ND 4.0 summary: <https://creativecommons.org/share-your-work/cclicenses/>
|
| 52 |
-
- CC BY-NC-ND 4.0 legal code: <https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode>
|
| 53 |
|
| 54 |
-
|
| 55 |
-
|
| 56 |
-
`_DATA/mano/*`
|
| 57 |
-
|
| 58 |
-
Official sources:
|
| 59 |
-
- Project page: <https://mano.is.tue.mpg.de/>
|
| 60 |
-
- License terms: <https://mano.is.tue.mpg.de/license.html>
|
| 61 |
-
- MPI code page: <https://is.mpg.de/code/embodied-hands>
|
| 62 |
|
|
|
|
| 63 |
|
| 64 |
## Required citations
|
| 65 |
|
| 66 |
-
If you use this repository, cite the corresponding EgoForce paper
|
| 67 |
|
| 68 |
```bibtex
|
| 69 |
@inproceedings{millerdurai2026egoforce,
|
|
@@ -74,34 +49,22 @@ If you use this repository, cite the corresponding EgoForce paper.
|
|
| 74 |
}
|
| 75 |
```
|
| 76 |
|
| 77 |
-
If you use the WiLoR detector
|
| 78 |
|
| 79 |
```bibtex
|
| 80 |
@InProceedings{Potamias_2025_CVPR,
|
| 81 |
author = {Potamias, Rolandos Alexandros and Zhang, Jinglei and Deng, Jiankang and Zafeiriou, Stefanos},
|
| 82 |
title = {WiLoR: End-to-end 3D Hand Localization and Reconstruction in-the-wild},
|
| 83 |
booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
|
| 84 |
-
|
| 85 |
-
year = {2025},
|
| 86 |
-
pages = {12242-12254}
|
| 87 |
}
|
| 88 |
-
```
|
| 89 |
-
|
| 90 |
-
If you use MANO assets or outputs parameterized by MANO, cite MANO:
|
| 91 |
|
| 92 |
-
```bibtex
|
| 93 |
@article{MANO:SIGGRAPHASIA:2017,
|
| 94 |
title = {Embodied Hands: Modeling and Capturing Hands and Bodies Together},
|
| 95 |
author = {Romero, Javier and Tzionas, Dimitrios and Black, Michael J.},
|
| 96 |
journal = {ACM Transactions on Graphics, (Proc. SIGGRAPH Asia)},
|
| 97 |
volume = {36},
|
| 98 |
number = {6},
|
| 99 |
-
series = {245:1--245:17},
|
| 100 |
-
month = nov,
|
| 101 |
year = {2017}
|
| 102 |
}
|
| 103 |
-
```
|
| 104 |
-
|
| 105 |
-
## Compliance note
|
| 106 |
-
|
| 107 |
-
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.
|
|
|
|
| 1 |
---
|
|
|
|
|
|
|
|
|
|
| 2 |
datasets:
|
| 3 |
- chris10/EgoForce
|
| 4 |
+
license: cc-by-nc-4.0
|
| 5 |
+
pipeline_tag: keypoint-detection
|
| 6 |
tags:
|
| 7 |
- egocentric-vision
|
| 8 |
- hand-tracking
|
| 9 |
- hand-pose-estimation
|
|
|
|
| 10 |
---
|
| 11 |
|
| 12 |
# EgoForce: Forearm-Guided Camera-Space 3D Hand Pose from a Monocular Egocentric Camera
|
|
|
|
| 13 |
|
| 14 |
+
[Project Page](https://dfki-av.github.io/EgoForce) | [Paper](https://arxiv.org/pdf/2605.12498) | [HF Paper](https://huggingface.co/papers/2605.12498) | [Code](https://github.com/dfki-av/EgoForce) | [Demo](https://huggingface.co/spaces/chris10/EgoForce)
|
| 15 |
|
| 16 |
+
EgoForce is a monocular 3D hand reconstruction framework that recovers robust, absolute 3D hand pose and its position from the user's (camera-space) viewpoint. It operates across fisheye, perspective, and distorted wide-FOV camera models using a single unified network.
|
| 17 |
|
| 18 |
## Repository contents
|
| 19 |
|
| 20 |
+
This repository contains EgoForce model assets and supporting files for egocentric hand and arm perception.
|
| 21 |
+
|
| 22 |
| Path | Role | Provenance | License / notice |
|
| 23 |
| --- | --- | --- | --- |
|
| 24 |
+
| `_DATA/detector.torchscript` | 2D hand bounding-box detector | WiLoR detector | Third-party asset; see WiLoR notice below |
|
| 25 |
| `_DATA/mano/*` | MANO hand model files | Official MANO distribution | Third-party asset; see MANO notice below |
|
| 26 |
| `_DATA/epoch_460.pth` | EgoForce hand-arm detector | EgoForce | First-party project asset |
|
| 27 |
| `_DATA/model_weights.pth` | EgoForce model | EgoForce | First-party project asset |
|
| 28 |
|
| 29 |
## Important licensing note
|
| 30 |
|
| 31 |
+
No single license applies to every file in this repository.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 32 |
|
| 33 |
+
- The **EgoForce** code and model weights are released under the [CC-BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/) license.
|
| 34 |
+
- `_DATA/detector.torchscript` is subject to the original **WiLoR** model license ([CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/)).
|
| 35 |
+
- `_DATA/mano/*` remains subject to the official **MANO** non-commercial research license.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 36 |
|
| 37 |
+
For detailed information, please refer to [`LICENSE.md`](LICENSE.md).
|
| 38 |
|
| 39 |
## Required citations
|
| 40 |
|
| 41 |
+
If you use this repository, please cite the corresponding EgoForce paper:
|
| 42 |
|
| 43 |
```bibtex
|
| 44 |
@inproceedings{millerdurai2026egoforce,
|
|
|
|
| 49 |
}
|
| 50 |
```
|
| 51 |
|
| 52 |
+
If you use the WiLoR detector or MANO assets bundled here, please cite their respective works:
|
| 53 |
|
| 54 |
```bibtex
|
| 55 |
@InProceedings{Potamias_2025_CVPR,
|
| 56 |
author = {Potamias, Rolandos Alexandros and Zhang, Jinglei and Deng, Jiankang and Zafeiriou, Stefanos},
|
| 57 |
title = {WiLoR: End-to-end 3D Hand Localization and Reconstruction in-the-wild},
|
| 58 |
booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
|
| 59 |
+
year = {2025}
|
|
|
|
|
|
|
| 60 |
}
|
|
|
|
|
|
|
|
|
|
| 61 |
|
|
|
|
| 62 |
@article{MANO:SIGGRAPHASIA:2017,
|
| 63 |
title = {Embodied Hands: Modeling and Capturing Hands and Bodies Together},
|
| 64 |
author = {Romero, Javier and Tzionas, Dimitrios and Black, Michael J.},
|
| 65 |
journal = {ACM Transactions on Graphics, (Proc. SIGGRAPH Asia)},
|
| 66 |
volume = {36},
|
| 67 |
number = {6},
|
|
|
|
|
|
|
| 68 |
year = {2017}
|
| 69 |
}
|
| 70 |
+
```
|
|
|
|
|
|
|
|
|
|
|
|