| # AdvancedLivePortrait-WebUI | |
| Dedicated gradio based WebUI for [ComfyUI-AdvancedLivePortrait](https://github.com/PowerHouseMan/ComfyUI-AdvancedLivePortrait). | |
| <br>You can edit the facial expression from the image. | |
| https://github.com/user-attachments/assets/08ebc8eb-3e60-49a6-ac1f-51311e788a27 | |
| # Installation And Running | |
| ### Prerequisite | |
| 1. `3.9` <= `python` <= `3.12` : https://www.python.org/downloads/release/python-3110/ | |
| ## Run Locally | |
| 1. git clone this repository | |
| ``` | |
| git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git | |
| ``` | |
| 2. Install dependencies ( Use `requirements-cpu.txt` if you're not using Nvidia GPU. ) | |
| ``` | |
| pip install -r requirements.txt | |
| ``` | |
| 3. Run app | |
| ``` | |
| python app.py | |
| ``` | |
| ## Run with PowerShell | |
| There're PowerShell scripts for each purpose : [`Install.ps1`](https://github.com/jhj0517/AdvancedLivePortrait-WebUI/blob/master/Install.ps1), [`Start-WebUI.ps1`](https://github.com/jhj0517/AdvancedLivePortrait-WebUI/blob/master/Start-WebUI.ps1) and [`Update.ps1`](https://github.com/jhj0517/AdvancedLivePortrait-WebUI/blob/master/Update.ps1). | |
| <br> They do the same things as above with `venv`, creating, activating `venv` and running the app etc. | |
| If you're using Windows, right-click the script and then click on ***Run with PowerShell***. | |
| ## Run with Docker | |
| 1. git clone this repository | |
| ``` | |
| git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git | |
| ``` | |
| 2. Build the imade | |
| ``` | |
| docker compose -f docker/docker-compose.yaml build | |
| ``` | |
| 3. Run the container | |
| ``` | |
| docker compose -f docker/docker-compose.yaml up | |
| ``` | |
| 4. Connect to `http://localhost:7860/` in browser. | |
| Update the [`docker-compose.yaml`](https://github.com/jhj0517/AdvancedLivePortrait-WebUI/blob/master/docker/docker-compose.yaml) to match your environment if you're not using an Nvidia GPU. | |
| ## ❤️ Citation and Thanks | |
| 1. LivePortrait paper comes from | |
| ```bibtex | |
| @article{guo2024liveportrait, | |
| title = {LivePortrait: Efficient Portrait Animation with Stitching and Retargeting Control}, | |
| author = {Guo, Jianzhu and Zhang, Dingyun and Liu, Xiaoqiang and Zhong, Zhizhou and Zhang, Yuan and Wan, Pengfei and Zhang, Di}, | |
| journal = {arXiv preprint arXiv:2407.03168}, | |
| year = {2024} | |
| } | |
| ``` | |
| 2. The models are safetensors that have been converted by kijai. : https://github.com/kijai/ComfyUI-LivePortraitKJ | |
| 3. [ultralytics](https://github.com/ultralytics/ultralytics) is used to detect the face. | |
| 4. This WebUI is started from [ComfyUI-AdvancedLivePortrait](https://github.com/PowerHouseMan/ComfyUI-AdvancedLivePortrait), various facial expressions like AAA, EEE, Eyebrow, Wink are found by PowerHouseMan. | |
| ### 🌐 Translation | |
| Any PRs for language translation for [`translation.yaml`](https://github.com/jhj0517/AdvancedLivePortrait-WebUI/blob/master/i18n/translation.yaml) would be greatly appreciated! | |