#  FaceXLib
[](https://pypi.org/project/facexlib/)
[](https://github.com/xinntao/facexlib/releases)
[](https://github.com/xinntao/facexlib/issues)
[](https://github.com/xinntao/facexlib/issues)
[](https://github.com/xinntao/facexlib/blob/master/LICENSE)
[](https://github.com/xinntao/facexlib/blob/master/.github/workflows/pylint.yml)
[](https://github.com/xinntao/facexlib/blob/master/.github/workflows/publish-pip.yml)
[English](README.md) **|** [简体中文](README_CN.md)
---
**facexlib** aims at providing ready-to-use **face-related** functions based on current SOTA open-source methods. <br>
Only PyTorch reference codes are available. For training or fine-tuning, please refer to their original repositories listed below. <br>
Note that we just provide a collection of these algorithms. You need to refer to their original LICENCEs for your intended use.
If facexlib is helpful in your projects, please help to :star: this repo. Thanks:blush: <br>
Other recommended projects:   :arrow_forward: [Real-ESRGAN](https://github.com/xinntao/Real-ESRGAN)   :arrow_forward: [GFPGAN](https://github.com/TencentARC/GFPGAN)   :arrow_forward: [BasicSR](https://github.com/xinntao/BasicSR)
---
## :sparkles: Functions
| Function | Sources | Original LICENSE |
| :--- | :---: | :---: |
| [Detection](facexlib/detection/README.md) | [Pytorch_Retinaface](https://github.com/biubug6/Pytorch_Retinaface) | MIT |
| [Alignment](facexlib/alignment/README.md) |[AdaptiveWingLoss](https://github.com/protossw512/AdaptiveWingLoss) | Apache 2.0 |
| [Recognition](facexlib/recognition/README.md) | [InsightFace_Pytorch](https://github.com/TreB1eN/InsightFace_Pytorch) | MIT |
| [Parsing](facexlib/parsing/README.md) | [face-parsing.PyTorch](https://github.com/zllrunning/face-parsing.PyTorch) | MIT |
| [Matting](facexlib/matting/README.md) | [MODNet](https://github.com/ZHKKKe/MODNet) | CC 4.0 |
| [Headpose](facexlib/headpose/README.md) | [deep-head-pose](https://github.com/natanielruiz/deep-head-pose) | Apache 2.0 |
| [Tracking](facexlib/tracking/README.md) | [SORT](https://github.com/abewley/sort) | GPL 3.0 |
| [Assessment](facexlib/assessment/README.md) | [hyperIQA](https://github.com/SSL92/hyperIQA) | - |
| [Utils](facexlib/utils/README.md) | Face Restoration Helper | - |
## :eyes: Demo and Tutorials
## :wrench: Dependencies and Installation
- Python >= 3.7 (Recommend to use [Anaconda](https://www.anaconda.com/download/#linux) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html))
- [PyTorch >= 1.7](https://pytorch.org/)
- Option: NVIDIA GPU + [CUDA](https://developer.nvidia.com/cuda-downloads)
### Installation
```bash
pip install facexlib
```
### Pre-trained models
It will **automatically** download pre-trained models at the first inference. <br>
If your network is not stable, you can download in advance (may with other download tools), and put them in the folder: `PACKAGE_ROOT_PATH/facexlib/weights`.
## :scroll: License and Acknowledgement
This project is released under the MIT license. <br>
## :e-mail: Contact
If you have any question, open an issue or email `xintao.wang@outlook.com`.
Raw data
{
"_id": null,
"home_page": "https://github.com/xinntao/facexlib",
"name": "facexlib",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "computer vision,face,detection,landmark,alignment",
"author": "Xintao Wang",
"author_email": "xintao.wang@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/e1/93/c820cd2c6315b635934770808e0b01ed4db257ec33bcf803909dcf4bce15/facexlib-0.3.0.tar.gz",
"platform": null,
"description": "#  FaceXLib\n\n[](https://pypi.org/project/facexlib/)\n[](https://github.com/xinntao/facexlib/releases)\n[](https://github.com/xinntao/facexlib/issues)\n[](https://github.com/xinntao/facexlib/issues)\n[](https://github.com/xinntao/facexlib/blob/master/LICENSE)\n[](https://github.com/xinntao/facexlib/blob/master/.github/workflows/pylint.yml)\n[](https://github.com/xinntao/facexlib/blob/master/.github/workflows/publish-pip.yml)\n\n[English](README.md) **|** [\u7b80\u4f53\u4e2d\u6587](README_CN.md)\n\n---\n\n**facexlib** aims at providing ready-to-use **face-related** functions based on current SOTA open-source methods. <br>\nOnly PyTorch reference codes are available. For training or fine-tuning, please refer to their original repositories listed below. <br>\nNote that we just provide a collection of these algorithms. You need to refer to their original LICENCEs for your intended use.\n\nIf facexlib is helpful in your projects, please help to :star: this repo. Thanks:blush: <br>\nOther recommended projects:   :arrow_forward: [Real-ESRGAN](https://github.com/xinntao/Real-ESRGAN)   :arrow_forward: [GFPGAN](https://github.com/TencentARC/GFPGAN)   :arrow_forward: [BasicSR](https://github.com/xinntao/BasicSR)\n\n---\n\n## :sparkles: Functions\n\n| Function | Sources | Original LICENSE |\n| :--- | :---: | :---: |\n| [Detection](facexlib/detection/README.md) | [Pytorch_Retinaface](https://github.com/biubug6/Pytorch_Retinaface) | MIT |\n| [Alignment](facexlib/alignment/README.md) |[AdaptiveWingLoss](https://github.com/protossw512/AdaptiveWingLoss) | Apache 2.0 |\n| [Recognition](facexlib/recognition/README.md) | [InsightFace_Pytorch](https://github.com/TreB1eN/InsightFace_Pytorch) | MIT |\n| [Parsing](facexlib/parsing/README.md) | [face-parsing.PyTorch](https://github.com/zllrunning/face-parsing.PyTorch) | MIT |\n| [Matting](facexlib/matting/README.md) | [MODNet](https://github.com/ZHKKKe/MODNet) | CC 4.0 |\n| [Headpose](facexlib/headpose/README.md) | [deep-head-pose](https://github.com/natanielruiz/deep-head-pose) | Apache 2.0 |\n| [Tracking](facexlib/tracking/README.md) | [SORT](https://github.com/abewley/sort) | GPL 3.0 |\n| [Assessment](facexlib/assessment/README.md) | [hyperIQA](https://github.com/SSL92/hyperIQA) | - |\n| [Utils](facexlib/utils/README.md) | Face Restoration Helper | - |\n\n## :eyes: Demo and Tutorials\n\n## :wrench: Dependencies and Installation\n\n- Python >= 3.7 (Recommend to use [Anaconda](https://www.anaconda.com/download/#linux) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html))\n- [PyTorch >= 1.7](https://pytorch.org/)\n- Option: NVIDIA GPU + [CUDA](https://developer.nvidia.com/cuda-downloads)\n\n### Installation\n\n```bash\npip install facexlib\n```\n\n### Pre-trained models\n\nIt will **automatically** download pre-trained models at the first inference. <br>\nIf your network is not stable, you can download in advance (may with other download tools), and put them in the folder: `PACKAGE_ROOT_PATH/facexlib/weights`.\n\n## :scroll: License and Acknowledgement\n\nThis project is released under the MIT license. <br>\n\n## :e-mail: Contact\n\nIf you have any question, open an issue or email `xintao.wang@outlook.com`.\n\n\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Basic face library",
"version": "0.3.0",
"split_keywords": [
"computer vision",
"face",
"detection",
"landmark",
"alignment"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "367b2147339dafe1c4800514c9c21ee4444f8b419ce51dfc7695220a8e0069a6",
"md5": "e4adc482fc8b40d7c61bd712a9cbf0eb",
"sha256": "245d58861537b820c616e8b3ef618ccfad2a24724a2d74be2b0542643c01a878"
},
"downloads": -1,
"filename": "facexlib-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e4adc482fc8b40d7c61bd712a9cbf0eb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 59624,
"upload_time": "2023-04-15T06:51:56",
"upload_time_iso_8601": "2023-04-15T06:51:56.841929Z",
"url": "https://files.pythonhosted.org/packages/36/7b/2147339dafe1c4800514c9c21ee4444f8b419ce51dfc7695220a8e0069a6/facexlib-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e193c820cd2c6315b635934770808e0b01ed4db257ec33bcf803909dcf4bce15",
"md5": "2ee768e91bd56c1f016bdede9f95cd51",
"sha256": "7ae784a520eb52e05583e8bf9f68f77f45083239ac754d646d635017b49e7763"
},
"downloads": -1,
"filename": "facexlib-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "2ee768e91bd56c1f016bdede9f95cd51",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1066362,
"upload_time": "2023-04-15T06:51:59",
"upload_time_iso_8601": "2023-04-15T06:51:59.169088Z",
"url": "https://files.pythonhosted.org/packages/e1/93/c820cd2c6315b635934770808e0b01ed4db257ec33bcf803909dcf4bce15/facexlib-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-15 06:51:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "xinntao",
"github_project": "facexlib",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "facexlib"
}
JSON
