{"id":20268981,"url":"https://github.com/1adrianb/human-pose-estimation","last_synced_at":"2025-04-11T03:50:54.454Z","repository":{"id":44395537,"uuid":"67652998","full_name":"1adrianb/human-pose-estimation","owner":"1adrianb","description":"This repository implements a demo of the Human pose estimation via Convolutional Part Heatmap Regression paper.","archived":false,"fork":false,"pushed_at":"2017-11-10T08:57:48.000Z","size":12,"stargazers_count":108,"open_issues_count":7,"forks_count":41,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-25T01:51:10.057Z","etag":null,"topics":["deep-learning","human-pose-estimation","keypoints","torch7"],"latest_commit_sha":null,"homepage":"https://www.adrianbulat.com/human-pose-estimation","language":"Lua","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/1adrianb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-09-08T00:13:08.000Z","updated_at":"2025-02-19T03:02:57.000Z","dependencies_parsed_at":"2022-07-15T02:46:55.638Z","dependency_job_id":null,"html_url":"https://github.com/1adrianb/human-pose-estimation","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/1adrianb%2Fhuman-pose-estimation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fhuman-pose-estimation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fhuman-pose-estimation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fhuman-pose-estimation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1adrianb","download_url":"https://codeload.github.com/1adrianb/human-pose-estimation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248339262,"owners_count":21087214,"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":["deep-learning","human-pose-estimation","keypoints","torch7"],"created_at":"2024-11-14T12:22:19.185Z","updated_at":"2025-04-11T03:50:54.438Z","avatar_url":"https://github.com/1adrianb.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Human pose estimation via Convolutional Part Heatmap Regression\n\nThis repository implements a demo of the Human pose estimation via Convolutional Part Heatmap Regression paper [Bulat](https://www.adrianbulat.com)\u0026[Tzimiropoulos](http://www.cs.nott.ac.uk/~pszyt/).\n\nNote: New code capable of running on devices with limited resources, for Human Pose Estimation and Face Alignment was released. For a demo please check: [https://github.com/1adrianb/binary-human-pose-estimation](https://github.com/1adrianb/binary-human-pose-estimation) \n\n## Requirement\n- Install the latest [Torch](http://torch.ch/docs/getting-started.html) version\n- Install python 2.7 using the package manager\n\n### Torch packages\n- [nn](https://github.com/torch/nn)\n- [cunn](https://github.com/torch/cunn) or [cudnn](https://github.com/soumith/cudnn.torch) (preffered) if you have a CUDA enabled GPU\n- [optnet](https://github.com/fmassa/optimize-net)\n- [xlua](https://github.com/torch/xlua)\n- [image](https://github.com/torch/image)\n- [sh](https://github.com/zserge/luash)\n- [fb.python](https://github.com/facebook/fblualib/blob/master/fblualib/python/README.md)\n\nMost of the listed package can be installed by simple running \n```bash\nluarocks install [packagename]\n```\nFor sh and fb.python packages please visit their github repositories and carrefully follow the instruction provided by their authors. \n\n### Python packages\n- [numpy](http://www.scipy.org/scipylib/download.html)\n- [matplotlib](http://matplotlib.org/users/installing.html) - required for plotting \n\n## Trained models\nBy default, on the first run the scripts will attempt to automatically download the models, however for your convinience they are provided also for separate usage.\n\n| Dataset used  | LSP error   | MPII  error |\n| ------------- | ----------- | ----------- |\n| [MPII](https://www.adrianbulat.com/downloads/ECCV16/human_pose_mpii.t7)          | -           | 89.7        |\n| [MPII + LSP](https://www.adrianbulat.com/downloads/ECCV16/human_pose_lsp.t7)    | 90.7        | -           |\n\n## Usage\n\nThe provided code comes along with a series of options. In order to list them please run:\n```bash\nth main.lua --help\n```\nTo run a demo on 10 random images:\n```bash\nth main.lua -dataset lsp \n```\n\nTo evaluate the model on the validation set for LSP/MPII:\n```bash\nth main.lua -dataset lsp -eval\n```\n\nIf you have installed cudnn4 or cudnn5 you can run the demo faster:\n```bash\nth main.lua -dataset lsp -eval -usecudnn\n```\n\nThe demo doesn't require a GPU, however having one will speed up the process.\n\n## Notes\n\nFor more details/questions please visit the [project page](https://www.adrianbulat.com/human-pose-estimation) or send an email at adrian.bulat@nottingham.ac.uk\n\nWarning: The script will download by default both the models and the dataset(~15Gb), if you wan't to avoid this or you already have them downloaded please move them in the corresponding folders \nin datasets/[datasetname]_dataset/. Running the demo for lsp dataset will require only ~700Mb of space.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1adrianb%2Fhuman-pose-estimation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1adrianb%2Fhuman-pose-estimation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1adrianb%2Fhuman-pose-estimation/lists"}