added readme

LICENSE.md

@@ -0,0 +1,73 @@
+# Repository Licensing and Third-Party Notices
+
+This repository contains a mixture of first-party EgoForce assets and third-party assets. No single license applies to all files in the repository.
+
+This notice is intended to make the third-party obligations visible at the repository root. It does not replace the original upstream licenses, which remain controlling for third-party files.
+
+## Summary
+
+| Path | Upstream source | Governing license / terms 
+| --- | --- | --- 
+| `_DATA/detector.torchscript` | WiLoR | CC BY-NC-ND 4.0 
+| `_DATA/mano/*` | MANO | MANO PS:License 1.0
+| `_DATA/epoch_460.pth` | EgoForce | First-party project asset 
+| `_DATA/model_weights.pth` | EgoForce | First-party project asset ers 
+
+## WiLoR notice
+
+The file `_DATA/detector.torchscript` is used in this repository as the 2D hand bounding-box detector.
+
+Official references:
+
+- WiLoR project page: <https://rolpotamias.github.io/WiLoR/>
+- WiLoR repository: <https://github.com/rolpotamias/WiLoR>
+- 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>
+- Creative Commons license: <https://creativecommons.org/licenses/by-nc-nd/4.0/>
+
+The official WiLoR repository states that WiLoR models are licensed under CC BY-NC-ND 4.0.
+
+Citation:
+
+```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}
+}
+```
+
+## MANO notice
+
+The directory `_DATA/mano/*` contains MANO hand model assets from the Max Planck MANO distribution.
+
+Official references:
+
+- MANO website: <https://mano.is.tue.mpg.de/>
+- MANO license: <https://mano.is.tue.mpg.de/license.html>
+- MPI code page: <https://is.mpg.de/code/embodied-hands>
+
+The official MANO license is the Max Planck "Software Copyright License for non-commercial scientific research purposes" (PS:License 1.0). 
+
+
+Citation:
+
+```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}
+}
+```
+
+
+## Disclaimer
+
+This file is provided for attribution and compliance transparency only. It is not legal advice. The original upstream licenses remain authoritative.

README.md

@@ -1,6 +1,94 @@
 ---
-license: cc-by-nc-4.0
+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.