Improve metadata and pipeline tag

#1
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +16 -53
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
- pipeline_tag: image-to-3d
 
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
- 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.
20
 
21
  ## Repository contents
22
 
 
 
23
  | Path | Role | Provenance | License / notice |
24
  | --- | --- | --- | --- |
25
- | `_DATA/detector.torchscript` | 2D hand bounding-box detector used in preprocessing | WiLoR detector | Third-party asset; see WiLoR notice below |
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
- ### MANO
55
-
56
- `_DATA/mano/*` contains MANO hand model assets from the Max Planck MANO distribution. The official MANO license is a separate non-commercial research license.
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 bundled in this repository, cite WiLoR:
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
- month = {June},
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
+ ```