# FaceFuison Python Lib
[FaceFusion](https://github.com/facefusion/facefusion) is a very nice face swapper and enhancer.
## Requirements
```
python: >=3.9
```
## Installation
CPU support:
```
pip install facefusionlib
```
GPU support:
First of all, you need to check if your system supports the `onnxruntime-gpu`.
Go to [https://onnxruntime.ai](https://onnxruntime.ai) and check the installation matrix.
![Preview](https://raw.githubusercontent.com/IAn2018cs/sd-webui-facefusion/dev/.github/onnxruntime-installation-matrix.png)
If yes, just run:
```
pip install facefusionlib[gpu]
```
## Usage
```python
from facefusionlib import swapper
from facefusionlib.swapper import DeviceProvider
input_path = 'input.png'
target_path = 'target.png'
result = swapper.swap_face(
source_paths=[input_path],
target_path=target_path,
provider=DeviceProvider.CPU,
detector_score=0.65,
mask_blur=0.7,
skip_nsfw=True,
landmarker_score=0.5
)
print(result)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/IAn2018cs/sd-webui-facefusion",
"name": "facefusionlib",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "face, swapper",
"author": "IAn2018",
"author_email": "ian2018cs@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/05/a7/06de1c3939770d1c556f5fead95ed0f4be09211e49f12459091790511002/facefusionlib-1.1.3.tar.gz",
"platform": null,
"description": "# FaceFuison Python Lib\n\n[FaceFusion](https://github.com/facefusion/facefusion) is a very nice face swapper and enhancer.\n\n## Requirements\n```\npython: >=3.9\n```\n\n## Installation\n\nCPU support:\n```\npip install facefusionlib\n```\n\nGPU support:\n\nFirst of all, you need to check if your system supports the `onnxruntime-gpu`.\n\nGo to [https://onnxruntime.ai](https://onnxruntime.ai) and check the installation matrix.\n\n![Preview](https://raw.githubusercontent.com/IAn2018cs/sd-webui-facefusion/dev/.github/onnxruntime-installation-matrix.png)\n\nIf yes, just run:\n\n```\npip install facefusionlib[gpu]\n```\n\n## Usage\n\n```python\nfrom facefusionlib import swapper\nfrom facefusionlib.swapper import DeviceProvider\n\ninput_path = 'input.png'\ntarget_path = 'target.png'\n\nresult = swapper.swap_face(\n\t\tsource_paths=[input_path],\n\t\ttarget_path=target_path,\n\t\tprovider=DeviceProvider.CPU,\n\t\tdetector_score=0.65,\n\t\tmask_blur=0.7,\n\t\tskip_nsfw=True,\n landmarker_score=0.5\n\t)\nprint(result)\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Face swapper and enhancer",
"version": "1.1.3",
"project_urls": {
"Homepage": "https://github.com/IAn2018cs/sd-webui-facefusion"
},
"split_keywords": [
"face",
" swapper"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "38c1c4ae721b34c49b31617f42c050acc443090c9c91c946469963d266cd9269",
"md5": "3ae8ffc0382dfe5d9665f8fa314ced2d",
"sha256": "27c66fdec4627066fca9ff3ffc18e59b604a6637a8a70e49dfec4383add12800"
},
"downloads": -1,
"filename": "facefusionlib-1.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3ae8ffc0382dfe5d9665f8fa314ced2d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 45478,
"upload_time": "2025-01-13T07:52:44",
"upload_time_iso_8601": "2025-01-13T07:52:44.519402Z",
"url": "https://files.pythonhosted.org/packages/38/c1/c4ae721b34c49b31617f42c050acc443090c9c91c946469963d266cd9269/facefusionlib-1.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "05a706de1c3939770d1c556f5fead95ed0f4be09211e49f12459091790511002",
"md5": "7a2d70a44ddc0447e16fb164abc8ff79",
"sha256": "51d4690a657f5aa80ac2c9e57f8d2a882bfcde894bc2fb66650796f2472f1d5f"
},
"downloads": -1,
"filename": "facefusionlib-1.1.3.tar.gz",
"has_sig": false,
"md5_digest": "7a2d70a44ddc0447e16fb164abc8ff79",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 33638,
"upload_time": "2025-01-13T07:52:47",
"upload_time_iso_8601": "2025-01-13T07:52:47.502656Z",
"url": "https://files.pythonhosted.org/packages/05/a7/06de1c3939770d1c556f5fead95ed0f4be09211e49f12459091790511002/facefusionlib-1.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-13 07:52:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "IAn2018cs",
"github_project": "sd-webui-facefusion",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "facefusionlib",
"specs": [
[
"==",
"1.1.3"
]
]
}
],
"lcname": "facefusionlib"
}