{"id":20268976,"url":"https://github.com/1adrianb/binary-face-alignment","last_synced_at":"2025-06-25T03:33:59.928Z","repository":{"id":71161834,"uuid":"81740083","full_name":"1adrianb/binary-face-alignment","owner":"1adrianb","description":"Real time face alignment ","archived":false,"fork":false,"pushed_at":"2021-04-27T17:35:10.000Z","size":17,"stargazers_count":147,"open_issues_count":5,"forks_count":45,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-11T03:51:37.935Z","etag":null,"topics":["binary-convolutions","computer-vision","convolutional-neural-networks","deep-learning","face-alignment","torch7"],"latest_commit_sha":null,"homepage":"","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-12T16:33:36.000Z","updated_at":"2024-02-01T02:53:05.000Z","dependencies_parsed_at":"2023-02-22T12:15:21.342Z","dependency_job_id":null,"html_url":"https://github.com/1adrianb/binary-face-alignment","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/1adrianb/binary-face-alignment","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fbinary-face-alignment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fbinary-face-alignment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fbinary-face-alignment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fbinary-face-alignment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1adrianb","download_url":"https://codeload.github.com/1adrianb/binary-face-alignment/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1adrianb%2Fbinary-face-alignment/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261798759,"owners_count":23211260,"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":["binary-convolutions","computer-vision","convolutional-neural-networks","deep-learning","face-alignment","torch7"],"created_at":"2024-11-14T12:22:12.285Z","updated_at":"2025-06-25T03:33:59.906Z","avatar_url":"https://github.com/1adrianb.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Binarized Convolutional Landmark Localizers for Human Pose Estimation and Face Alignment with Limited Resources (Face Alignment demo)\n\nThis code implements a demo of the Binarized Convolutional Landmark Localizers for Human Pose Estimation and Face Alignment with Limited Resources paper by Adrian Bulat and Georgios Tzimiropoulos. \n\nFor the human pose estimation demo please see [https://github.com/1adrianb/binary-human-pose-estimation](https://github.com/1adrianb/binary-human-pose-estimation)\n\n**[2021 Update]: PyTorch repo with training code for BNN available here: [https://github.com/1adrianb/binary-networks-pytorch](https://github.com/1adrianb/binary-networks-pytorch)**\n\n## Requirements\n- Install the latest [Torch7](http://torch.ch/docs/getting-started.html) version (for Windows, please follow the instructions avaialable [here](https://github.com/torch/distro/blob/master/win-files/README.md))\n\n### Packages\n- [cutorch](https://github.com/torch/cutorch)\n- [nn](https://github.com/torch/nn)\n- [cudnn](https://github.com/soumith/cudnn.torch) (cudnn5 preffered)\n- [xlua](https://github.com/torch/xlua)\n- [image](https://github.com/torch/image)\n- [gnuplot](https://github.com/torch/gnuplot)\n- [cURL](https://github.com/Lua-cURL/Lua-cURLv3)\n- [paths](https://github.com/torch/paths)\n\n```bash\nfor pkg in cutorch nn cudnn xlua image gnuplot lua-cURL paths; do luarocks install ${pkg}; done\n```\n\n## Setup\nClone the github repository\n```bash\ngit clone https://github.com/1adrianb/binary-face-alignment --recursive\ncd binary-face-alignment\n```\n\nBuild and install the BinaryConvolution package\n```bash\ncd bnn.torch/; luarocks make; cd ..;\n```\n\nInstall the modified optnet package\n```bash\ncd optimize-net/; luarocks make rocks/optnet-scm-1.rockspec; cd ..;\n```\n\nRun the following command to prepare the files required by the demo. This will download the AFLW2000-3D dataset alongside the converted dataset structure.\n```bash\nth download-content.lua\n```\n\n## Usage\n\nIn order to run the demo simply type:\n```bash\nmkdir models \u0026\u0026 wget https://www.adrianbulat.com/downloads/BinaryHumanPose/facealignment_binary_aflw.t7 -O models/facealignment_binary_aflw.t7\nth main.lua\n```\n\n## Pretrained models\n\n| Layer type | Model Size | AFLW2000-3D NME error |\n| ------------- | ----------- | ----------- |\n| [AFLW2000-3D](https://www.adrianbulat.com/downloads/BinaryHumanPose/facealignment_binary_aflw.t7)        | 1.4MB |3.28        |\n\nNote: More pretrained models will be added soon. \n\n## Notes\n\nFor more details/questions please visit the [project page](https://www.adrianbulat.com/binary-cnn-landmarks) or send an email at adrian.bulat@nottingham.ac.uk\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1adrianb%2Fbinary-face-alignment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1adrianb%2Fbinary-face-alignment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1adrianb%2Fbinary-face-alignment/lists"}