Spaces:
Runtime error
Runtime error
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,102 +1,13 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 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 [](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 |
-

|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
## Examples
|
| 31 |
-
Images generated with our PuLID
|
| 32 |
-

|
| 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|