{"id":23233350,"url":"https://github.com/cubiq/PuLID_ComfyUI","last_synced_at":"2025-08-19T18:31:44.105Z","repository":{"id":238887260,"uuid":"797748558","full_name":"cubiq/PuLID_ComfyUI","owner":"cubiq","description":"PuLID native implementation for ComfyUI","archived":false,"fork":false,"pushed_at":"2024-10-05T16:21:01.000Z","size":1516,"stargazers_count":735,"open_issues_count":54,"forks_count":43,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-12-14T11:00:30.185Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cubiq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-08T12:47:26.000Z","updated_at":"2024-12-12T17:05:04.000Z","dependencies_parsed_at":"2024-05-08T18:06:19.249Z","dependency_job_id":"cf0ed78d-773c-480f-a114-5444ac41a120","html_url":"https://github.com/cubiq/PuLID_ComfyUI","commit_stats":{"total_commits":22,"total_committers":7,"mean_commits":3.142857142857143,"dds":0.6363636363636364,"last_synced_commit":"4e1fd4024cae77a0c53edb8ecc3c8ee04027ebef"},"previous_names":["cubiq/pulid_comfyui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubiq%2FPuLID_ComfyUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubiq%2FPuLID_ComfyUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubiq%2FPuLID_ComfyUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubiq%2FPuLID_ComfyUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cubiq","download_url":"https://codeload.github.com/cubiq/PuLID_ComfyUI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230367780,"owners_count":18215325,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-19T03:01:23.039Z","updated_at":"2025-08-19T18:31:44.081Z","avatar_url":"https://github.com/cubiq.png","language":"Python","funding_links":[],"categories":["Workflows (3395) sorted by GitHub Stars","All Workflows Sorted by GitHub Stars"],"sub_categories":[],"readme":"# PuLID ComfyUI\n\n[PuLID](https://github.com/ToTheBeginning/PuLID) ComfyUI native implementation.\n\n![basic workflow](examples/pulid_wf.jpg)\n\n\u003e [!IMPORTANT]  \n\u003e **2025.04.14** - I do not use ComfyUI as my main way to interact with Gen AI anymore as a result I'm setting the repository in \"maintenance only\" mode. If there are crucial updates or PRs I might still consider merging them but I do not plan any consistent work on this repo.\n\n## Notes\n\nThe code can be considered beta, things may change in the coming days. In the `examples` directory you'll find some basic workflows.\n\nThe original implementation makes use of a [4-step lighting UNet](https://huggingface.co/ByteDance/SDXL-Lightning). I made a few comparisons with the official Gradio demo using the same model in ComfyUI and I can't see any noticeable difference, meaning that this code should be faithful to the orignal. The Lightning lora doesn't work as well.\n\nTesting other models though I noticed some quality degradation. You may need to experiment with CFG and various samplers/schedulers (try `sgm_uniform`).\n\n**The quality of the reference image is very important**. Maybe this is because of the Eva CLIP that gets more details. Be sure to use a clean and sharp picture!\n\n**For IPAdapter compatibility you need to update the IPAdapter extension!**\n\n## The 'method' parameter\n\n`method` applies the weights in different ways. `Fidelity` is closer to the reference ID, `Style` leaves more freedom to the checkpoint. Sometimes the difference is minimal. I've added `neutral` that doesn't do any normalization, if you use this option with the standard Apply node be sure to lower the weight. With the Advanced node you can simply increase the `fidelity` value.\n\nThe Advanced node has a `fidelity` slider and a `projection` option. `ortho_v2` with `fidelity: 8` is the same as `fidelity` method in the standard node. Projection `ortho` and `fidelity: 16` is the same as method `style`.\n\n**Lower `fidelity` values grant higher resemblance to the reference image.**\n\n## Installation\n\n- [PuLID pre-trained model](https://huggingface.co/huchenlei/ipadapter_pulid/resolve/main/ip-adapter_pulid_sdxl_fp16.safetensors?download=true) goes in `ComfyUI/models/pulid/` (thanks to [Chenlei Hu](https://github.com/huchenlei) for converting them into IPAdapter format)\n- The EVA CLIP is EVA02-CLIP-L-14-336, but should be downloaded automatically (will be located in the huggingface directory).\n- `facexlib` dependency needs to be installed, the models are downloaded at first use\n- Finally you need InsightFace with [AntelopeV2](https://huggingface.co/MonsterMMORPG/tools/tree/main), the unzipped models should be placed in `ComfyUI/models/insightface/models/antelopev2`.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcubiq%2FPuLID_ComfyUI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcubiq%2FPuLID_ComfyUI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcubiq%2FPuLID_ComfyUI/lists"}