{"id":13699786,"url":"https://github.com/YuvalNirkin/face_swap","last_synced_at":"2025-05-04T17:30:55.392Z","repository":{"id":41514119,"uuid":"88741039","full_name":"YuvalNirkin/face_swap","owner":"YuvalNirkin","description":"End-to-end, automatic face swapping pipeline","archived":false,"fork":false,"pushed_at":"2018-12-05T11:55:59.000Z","size":251,"stargazers_count":827,"open_issues_count":12,"forks_count":203,"subscribers_count":47,"default_branch":"master","last_synced_at":"2024-11-13T05:36:13.354Z","etag":null,"topics":["3d-reconstruction","expressions","face","fitting","segmentation","swap"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YuvalNirkin.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}},"created_at":"2017-04-19T12:15:21.000Z","updated_at":"2024-10-17T05:57:49.000Z","dependencies_parsed_at":"2022-08-10T02:35:22.182Z","dependency_job_id":null,"html_url":"https://github.com/YuvalNirkin/face_swap","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuvalNirkin%2Fface_swap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuvalNirkin%2Fface_swap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuvalNirkin%2Fface_swap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuvalNirkin%2Fface_swap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YuvalNirkin","download_url":"https://codeload.github.com/YuvalNirkin/face_swap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252371646,"owners_count":21737373,"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-reconstruction","expressions","face","fitting","segmentation","swap"],"created_at":"2024-08-02T20:00:43.428Z","updated_at":"2025-05-04T17:30:54.864Z","avatar_url":"https://github.com/YuvalNirkin.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"# End-to-end, automatic face swapping pipeline\n![alt text](https://yuvalnirkin.github.io/assets/img/projects/face_swap/joker_teaser.jpg \"Samples\")\nThe Joker (Heath Ledger) swapped using our method onto very different subjects and images.\n\n[Yuval Nirkin](http://www.nirkin.com/), [Iacopo Masi](http://www-bcf.usc.edu/~iacopoma/), [Anh Tuan Tran](https://sites.google.com/site/anhttranusc/), [Tal Hassner](http://www.openu.ac.il/home/hassner/), and [Gerard Medioni](http://iris.usc.edu/people/medioni/index.html).\n\n# Overview\nCode for the automatic, image-to-image face swapping method described in the paper:\n\nYuval Nirkin, Iacopo Masi, Anh Tuan Tran, Tal Hassner, Gerard Medioni, \"[On Face Segmentation, Face Swapping, and Face Perception](https://arxiv.org/abs/1704.06729)\", IEEE Conference on Automatic Face and Gesture Recognition (FG), Xi'an, China on May 2018\n\nPlease see [project page](http://www.openu.ac.il/home/hassner/projects/faceswap/) for more details, more resources and updates on this project.\n\nIf you find this code useful, please make sure to cite our paper in your work.\n\n## News\nVersion 1.0 is released:\n- Better performance and results.\n- Python binding.\n- Easier to build: removed many of the dependencies.\n- Software renderer: OpenGL is no longer required, the project can now be built on gui-less servers without any problems. \n- Added low resolution segmentation model for GPUs with low memory.\n\n## Installation\nBoth Linux and Windows are supported.\n- [Ubuntu installation guide](https://github.com/YuvalNirkin/face_swap/wiki/Ubuntu-Installation-Guide)\n- [Windows installation guide](https://github.com/YuvalNirkin/face_swap/wiki/Windows-Installation-Guide)\n\n## Usage\n- For Python follow the [Python guide](https://github.com/YuvalNirkin/face_swap/wiki/Python-Guide)\n- For running the applications follow the [applications guide](https://github.com/YuvalNirkin/face_swap/wiki/Applications-Guide).\n- For using the library's C++ interface, please take a look at the [Doxygen generated documentation](https://yuvalnirkin.github.io/docs/face_swap/).\n\n## Citation\nPlease cite our paper with the following bibtex if you use our face renderer:\n\n``` latex\n@inproceedings{nirkin2018_faceswap,\n      title={On Face Segmentation, Face Swapping, and Face Perception},\n      booktitle = {IEEE Conference on Automatic Face and Gesture Recognition},\n      author={Nirkin, Yuval and Masi, Iacopo and Tran, Anh Tuan and Hassner, Tal and Medioni, G\\'{e}rard},\n      year={2018},\n    }\n```\n\n## Related projects\n- [Deep face segmentation](https://github.com/YuvalNirkin/face_segmentation), used to segment face regions in the face swapping pipeline.\n- [Interactive system for fast face segmentation ground truth labeling](https://github.com/YuvalNirkin/face_video_segment), used to produce the training set for our deep face segmentation.\n- [CNN3DMM](http://www.openu.ac.il/home/hassner/projects/CNN3DMM/), used to estimate 3D face shapes from single images.\n- [ResFace101](http://www.openu.ac.il/home/hassner/projects/augmented_faces/), deep face recognition used in the paper to test face swapping capabilities.\n- [Hand augmentations](https://github.com/YuvalNirkin/egohands_augmentations), used to generate the hand augmentations for training the face segmentation.\n\n## Copyright\nCopyright 2018, Yuval Nirkin, Iacopo Masi, Anh Tuan Tran, Tal Hassner, and Gerard Medioni \n\nThe SOFTWARE provided in this page is provided \"as is\", without any guarantee made as to its suitability or fitness for any particular use. It may contain bugs, so use of this tool is at your own risk. We take no responsibility for any damage of any sort that may unintentionally be caused through its use.\n\n## License\nThis project is released under the GPLv3 license.\n\nFor a more permitting license please contact the [author](mailto:yuval.nirkin@gmail.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYuvalNirkin%2Fface_swap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FYuvalNirkin%2Fface_swap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FYuvalNirkin%2Fface_swap/lists"}