jhj0517 commited on
Commit
baccd24
1 Parent(s): 79580b2

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +66 -0
README.md ADDED
@@ -0,0 +1,66 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # AdvancedLivePortrait-WebUI
2
+
3
+ Dedicated gradio based WebUI for [ComfyUI-AdvancedLivePortrait](https://github.com/PowerHouseMan/ComfyUI-AdvancedLivePortrait).
4
+ <br>You can edit the facial expression from the image.
5
+
6
+ https://github.com/user-attachments/assets/08ebc8eb-3e60-49a6-ac1f-51311e788a27
7
+
8
+ # Installation And Running
9
+ ### Prerequisite
10
+ 1. `3.9` <= `python` <= `3.12` : https://www.python.org/downloads/release/python-3110/
11
+
12
+ ## Run Locally
13
+ 1. git clone this repository
14
+ ```
15
+ git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git
16
+ ```
17
+ 2. Install dependencies ( Use `requirements-cpu.txt` if you're not using Nvidia GPU. )
18
+ ```
19
+ pip install -r requirements.txt
20
+ ```
21
+ 3. Run app
22
+ ```
23
+ python app.py
24
+ ```
25
+
26
+ ## Run with PowerShell
27
+ 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).
28
+ <br> They do the same things as above with `venv`, creating, activating `venv` and running the app etc.
29
+
30
+ If you're using Windows, right-click the script and then click on ***Run with PowerShell***.
31
+
32
+ ## Run with Docker
33
+ 1. git clone this repository
34
+ ```
35
+ git clone https://github.com/jhj0517/AdvancedLivePortrait-WebUI.git
36
+ ```
37
+ 2. Build the imade
38
+ ```
39
+ docker compose -f docker/docker-compose.yaml build
40
+ ```
41
+ 3. Run the container
42
+ ```
43
+ docker compose -f docker/docker-compose.yaml up
44
+ ```
45
+ 4. Connect to `http://localhost:7860/` in browser.
46
+
47
+ 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.
48
+
49
+ ## Citation and Thanks
50
+ 1. LivePortrait paper comes from
51
+ ```bibtex
52
+ @article{guo2024liveportrait,
53
+ title = {LivePortrait: Efficient Portrait Animation with Stitching and Retargeting Control},
54
+ author = {Guo, Jianzhu and Zhang, Dingyun and Liu, Xiaoqiang and Zhong, Zhizhou and Zhang, Yuan and Wan, Pengfei and Zhang, Di},
55
+ journal = {arXiv preprint arXiv:2407.03168},
56
+ year = {2024}
57
+ }
58
+ ```
59
+ 2. The models are safetensors that have been converted by kijai. : https://github.com/kijai/ComfyUI-LivePortraitKJ
60
+ 3. [ultralytics](https://github.com/ultralytics/ultralytics) is used to detect the face.
61
+ 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.
62
+
63
+ ### 🌐 Translation
64
+ Any PRs for language translation for [`translation.yaml`](https://github.com/jhj0517/AdvancedLivePortrait-WebUI/blob/master/i18n/translation.yaml) would be greatly appreciated!
65
+
66
+