{"id":17703159,"url":"https://github.com/otaheri/MANO","last_synced_at":"2025-03-13T05:31:19.342Z","repository":{"id":42182609,"uuid":"284946072","full_name":"otaheri/MANO","owner":"otaheri","description":"A PyTorch Implementation of MANO hand model.","archived":false,"fork":false,"pushed_at":"2023-08-31T10:06:46.000Z","size":635,"stargazers_count":277,"open_issues_count":7,"forks_count":35,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-25T21:55:20.251Z","etag":null,"topics":["3d-viewer","hand","hand-modeling","human-hand-model","mano","pytorch"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/otaheri.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-08-04T10:20:57.000Z","updated_at":"2024-10-23T07:24:22.000Z","dependencies_parsed_at":"2022-09-01T17:32:01.332Z","dependency_job_id":"a75260b7-c130-48f7-9626-531082b31c0d","html_url":"https://github.com/otaheri/MANO","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otaheri%2FMANO","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otaheri%2FMANO/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otaheri%2FMANO/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otaheri%2FMANO/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/otaheri","download_url":"https://codeload.github.com/otaheri/MANO/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243351257,"owners_count":20276894,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-viewer","hand","hand-modeling","human-hand-model","mano","pytorch"],"created_at":"2024-10-24T20:01:39.924Z","updated_at":"2025-03-13T05:31:19.333Z","avatar_url":"https://github.com/otaheri.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# MANO\nA pytorch Implementation of MANO hand model\n\n# Description\n\nThis is a pytorch implementation of [MANO](https://mano.is.tue.mpg.de/) hand model loader. The code is based on [smplx](https://github.com/vchoutas/smplx) package by [Vassilis Choutas](https://ps.is.tuebingen.mpg.de/person/vchoutas).\n\nMANO is a differentiable hand model that can map hand pose parameters (joint angles and root location) and shape parameters into a 3D hand mesh. The model is very realistic, has low-dimensions, and can fit any human hand.\n\nThis repo was developed to be used in the [GrabNet](https://github.com/otaheri/GrabNet) model to generate realistic hand grasps for unseen 3D objects.\n\n![teaser](images/teaser.png)\n\n### Requirements\n  * [Pytorch\u003e=1.1.0](https://pytorch.org/get-started/locally/) \n  \n### Installation\nIf Pytorch is not installed run the following code for cpu version:\n```\npip install torch==1.5.1+cpu torchvision==0.6.1+cpu -f https://download.pytorch.org/whl/torch_stable.html\n```\nor install the right PyTorch GPU version.\n\n```\npip install git+'https://github.com/otaheri/MANO'\n\n```\n\n### Downloading models\n\nInorder to download hand models:\n* please register at the [MANO](https://mano.is.tue.mpg.de/) website and download the models.\n* put the models in a folder with the folowing structure\n```bash\nmodels\n|\n└── mano\n    ├── MANO_RIGHT.pkl\n    └── MANO_LEFT.pkl\n\n```\n\n### Examples\n\n```python\n\nimport torch\nimport mano\nfrom mano.utils import Mesh\n\nmodel_path = 'PATH_TO_MANO_MODELS'\nn_comps = 45\nbatch_size = 10\n\nrh_model = mano.load(model_path=model_path,\n                     is_rhand= True,\n                     num_pca_comps=n_comps,\n                     batch_size=batch_size,\n                     flat_hand_mean=False)\n\nbetas = torch.rand(batch_size, 10)*.1\npose = torch.rand(batch_size, n_comps)*.1\nglobal_orient = torch.rand(batch_size, 3)\ntransl        = torch.rand(batch_size, 3)\n\noutput = rh_model(betas=betas,\n                  global_orient=global_orient,\n                  hand_pose=pose,\n                  transl=transl,\n                  return_verts=True,\n                  return_tips = True)\n\n\nh_meshes = rh_model.hand_meshes(output)\nj_meshes = rh_model.joint_meshes(output)\n\n#visualize hand mesh only\nh_meshes[0].show()\n\n#visualize joints mesh only\nj_meshes[0].show()\n\n#visualize hand and joint meshes\nhj_meshes = Mesh.concatenate_meshes([h_meshes[0], j_meshes[0]])\nhj_meshes.show() \n\n```\n\n##### Results (Click on the image to open 3D viewer):\n\n[![3D-viewer](images/rhand.png)](https://grab.is.tue.mpg.de/uploads/ckeditor/attachments/564/rhand.html)\n\n### Citation\n\nIf you use this model for your research, please consider citing:\n\n\n```\n@article{MANO:SIGGRAPHASIA:2017,\n  title = {Embodied Hands: Modeling and Capturing Hands and Bodies Together},\n  author = {Romero, Javier and Tzionas, Dimitrios and Black, Michael J.},\n  journal = {ACM Transactions on Graphics, (Proc. SIGGRAPH Asia)},\n  publisher = {ACM},\n  month = nov,\n  year = {2017},\n  url = {http://doi.acm.org/10.1145/3130800.3130883},\n  month_numeric = {11}\n}\n```\nand \n```\n@inproceedings{GRAB:2020,\n  title = {{GRAB}: A Dataset of Whole-Body Human Grasping of Objects},\n  author = {Taheri, Omid and Ghorbani, Nima and Black, Michael J. and Tzionas, Dimitrios},\n  booktitle = {European Conference on Computer Vision (ECCV)},\n  year = {2020},\n  url = {https://grab.is.tue.mpg.de}\n}\n```\n\n### License\n\nSoftware Copyright License for **non-commercial scientific research purposes**.\nPlease read carefully the [terms and conditions](https://github.com/otaheri/MANO/blob/master/LICENSE) and any accompanying documentation before you download and/or use the MANO model, data and software, (the \"Model \u0026 Software\"), including 3D meshes, blend weights, blend shapes, software, scripts, and animations. By downloading and/or using the Model \u0026 Software (including downloading, cloning, installing, and any other use of this github repository), you acknowledge that you have read these terms and conditions, understand them, and agree to be bound by them. If you do not agree with these terms and conditions, you must not download and/or use the Model \u0026 Software. Any infringement of the terms of this agreement will automatically terminate your rights under this [License](./LICENSE).\n\n## Contact\nThe code of this repository was implemented by [Omid Taheri](https://ps.is.tuebingen.mpg.de/person/otaheri).\n\nFor questions, please contact [mano@tue.mpg.de](mano@tue.mpg.de).\n\nFor commercial licensing (and all related questions for business applications), please contact [ps-licensing@tue.mpg.de](ps-licensing@tue.mpg.de).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotaheri%2FMANO","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fotaheri%2FMANO","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotaheri%2FMANO/lists"}