Manikandan97 commited on
Commit
00db6ba
1 Parent(s): ff271bf

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +13 -102
README.md CHANGED
@@ -1,102 +1,13 @@
1
- # PuLID
2
-
3
- ### :open_book: PuLID: Pure and Lightning ID Customization via Contrastive Alignment
4
- > [![arXiv](https://img.shields.io/badge/arXiv-Paper-<COLOR>.svg)](https://arxiv.org/abs/2404.16022) [![xl](https://img.shields.io/badge/🤗-HuggingFaceDemo-orange)](https://huggingface.co/spaces/yanze/PuLID) [![flux](https://img.shields.io/badge/🤗-PuLID_FLUX_demo-orange)](https://huggingface.co/spaces/yanze/PuLID-FLUX) <br>
5
- > Zinan Guo*, Yanze Wu*✝, Zhuowei Chen, Lang Chen, Qian He <br>
6
- > (*Equal Contribution, ✝Corresponding Author) <br>
7
- > ByteDance Inc <br>
8
-
9
- ### :triangular_flag_on_post: Updates
10
- * **2024.09.12**: 💥 We're thrilled to announce the release of the **PuLID-FLUX-v0.9.0 model**. Enjoy exploring its capabilities! 😊 [Learn more about this model](docs/pulid_for_flux.md)
11
- * **2024.05.23**: share the [preview of our upcoming v1.1 model](docs/v1.1_preview.md), please stay tuned
12
- * **2024.05.01**: release v1 codes&models, also the [🤗HuggingFace Demo](https://huggingface.co/spaces/yanze/PuLID)
13
- * **2024.04.25**: release arXiv paper.
14
-
15
- ## PuLID for FLUX
16
- Please check the doc and demo of PuLID-FLUX [here](docs/pulid_for_flux.md).
17
-
18
- We will actively update and maintain this repository in the near future, so please stay tuned.
19
-
20
- ### updates
21
- - [x] Local gradio demo is ready now
22
- - [x] Online HuggingFace demo is ready now [![flux](https://img.shields.io/badge/🤗-PuLID_FLUX_demo-orange)](https://huggingface.co/spaces/yanze/PuLID-FLUX)
23
- - [x] We have optimized the codes to support consumer-grade GPUS, and now **PuLID-FLUX can run on a 16GB graphic card**. Check the details [here](https://github.com/ToTheBeginning/PuLID/blob/main/docs/pulid_for_flux.md#local-gradio-demo)
24
-
25
-
26
- Below results are generated with PuLID-FLUX.
27
- ![pulid_flux_results](https://github.com/user-attachments/assets/7eafb90a-fdd1-4ae7-bc41-8c428d568848)
28
-
29
-
30
- ## Examples
31
- Images generated with our PuLID
32
- ![examples](https://github.com/ToTheBeginning/PuLID/assets/11482921/65610b0d-ba4f-4dc3-a74d-bd60f8f5ce37)
33
- Applications
34
-
35
- https://github.com/ToTheBeginning/PuLID/assets/11482921/9bdd0c8a-99e8-4eab-ab9e-39bf796cc6b8
36
-
37
- ## :wrench: Dependencies and Installation
38
- - Python >= 3.9 (Recommend to use [Anaconda](https://www.anaconda.com/download/#linux) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html))
39
- - [PyTorch >= 2.0](https://pytorch.org/) if you don't need flux-dev-fp8, otherwise [PyTorch >= 2.4.1](https://pytorch.org/)
40
- ```bash
41
- # clone PuLID repo
42
- git clone https://github.com/ToTheBeginning/PuLID.git
43
- cd PuLID
44
- # create conda env
45
- conda create --name pulid python=3.10
46
- # activate env
47
- conda activate pulid
48
- # Install dependent packages
49
- # 1. if you don't need flux-fp8, e.g., you are using xl or flux-bf16, install the following requirements.txt
50
- pip install -r requirements.txt
51
- # 2. if you need flux-fp8 (to put flux on consumer-grade gpu), install the following requirements_fp8.txt
52
- pip install -r requirements_fp8.txt
53
- ```
54
-
55
- ## :zap: Quick Inference
56
- ### Local Gradio Demo
57
- ```bash
58
- python app.py
59
- ```
60
-
61
- ### Online HuggingFace Demo
62
- Thanks for the GPU grant from HuggingFace team, you can try PuLID HF demo in
63
- [https://huggingface.co/spaces/yanze/PuLID](https://huggingface.co/spaces/yanze/PuLID)
64
-
65
- ## :paperclip: Related Resources
66
- Following are some third-party implementations of PuLID we have found in the Internet.
67
- We appreciate the efforts of the respective developers for making PuLID accessible to a wider audience.
68
- If there are any PuLID based resources and applications that we have not mentioned here, please let us know,
69
- and we will include them in this list.
70
-
71
- #### Online Demo
72
- - **Colab**: https://github.com/camenduru/PuLID-jupyter provided by [camenduru](https://github.com/camenduru)
73
- - **Replicate**: https://replicate.com/zsxkib/pulid provided by [zsxkib](https://replicate.com/zsxkib)
74
-
75
- #### ComfyUI
76
- - https://github.com/cubiq/PuLID_ComfyUI provided by [cubiq](https://github.com/cubiq), native ComfyUI implementation
77
- - https://github.com/ZHO-ZHO-ZHO/ComfyUI-PuLID-ZHO provided by [ZHO](https://github.com/ZHO-ZHO-ZHO), diffusers-based implementation
78
-
79
- #### WebUI
80
- - https://github.com/Mikubill/sd-webui-controlnet/pull/2838 provided by [huchenlei](https://github.com/huchenlei)
81
-
82
- ## Disclaimer
83
- This project strives to impact the domain of AI-driven image generation positively. Users are granted the freedom to
84
- create images using this tool, but they are expected to comply with local laws and utilize it responsibly.
85
- The developers do not assume any responsibility for potential misuse by users.
86
-
87
-
88
- ## Citation
89
- If PuLID is helpful, please help to ⭐ the repo.
90
-
91
- If you find this project useful for your research, please consider citing our paper:
92
- ```bibtex
93
- @article{guo2024pulid,
94
- title={PuLID: Pure and Lightning ID Customization via Contrastive Alignment},
95
- author={Guo, Zinan and Wu, Yanze and Chen, Zhuowei and Chen, Lang and He, Qian},
96
- journal={arXiv preprint arXiv:2404.16022},
97
- year={2024}
98
- }
99
- ```
100
-
101
- ## :e-mail: Contact
102
- If you have any comments or questions, please [open a new issue](https://github.com/ToTheBeginning/PuLID/issues/new/choose) or feel free to contact [Yanze Wu](https://tothebeginning.github.io/) and [Zinan Guo](mailto:[email protected]).
 
1
+ ---
2
+ title: PuLID-FLUX
3
+ emoji: 🤗
4
+ colorFrom: blue
5
+ colorTo: indigo
6
+ sdk: gradio
7
+ sdk_version: 4.44.0
8
+ app_file: app.py
9
+ pinned: false
10
+ license: apache-2.0
11
+ ---
12
+
13
+ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference