A ComfyUI custom node that allows you to download models and other assets used in ComfyUI workflows from external sources like Hugging Face and CivitAI directly within your workflows to make it easier to share workflows and save time finding and downloading all the assets needed.
- Download models, checkpoints, VAEs, and other assets from external URLs
- Specify custom save locations within your ComfyUI models directory
- Support for authenticated downloads using API tokens
- Visual progress indicator during downloads
- Embed download nodes directly in your workflows to ensure dependencies are available
Search and install Comfy Asset Downloader from ComfyUI's Manager Custom Nodes Manager.
git clone https://github.com/ServiceStack/comfy-asset-downloader \
ComfyUI/custom_nodes/comfy-asset-downloaderTo download models and resources from CivitAI or protected Hugging Face repositories we recommend your ComfyUI
instance has these environment variables (e.g. by adding to ~/.profile):
export HF_TOKEN=hf_xxx
export CIVITAI_TOKEN=civitai_token
Restart ComfyUI after installation.
The Asset Downloader node provides a simple interface:
- url: The direct URL to the file you want to download
- save_to: The subfolder within your ComfyUI models directory to save the file
- filename: The name to save the file as
- token (optional): API token for authenticated downloads (e.g. for CivitAI or private Hugging Face repositories)
For ease of use and security the token can be prefixed with $ to use an environment variable (e.g. $HF_TOKEN or $CIVITAI_TOKEN) for the token available to the ComfyUI instance.
This will use the value of the HF_TOKEN environment variable if it exists.
- Add an
AssetDownloadernode to your workflow - Set the URL to a model file (e.g.,
https://huggingface.co/model-repo/resolve/main/the_model.safetensors) - Choose the appropriate save location (e.g.
checkpoints) - Set the filename (e.g.,
the_model.safetensors) - Run the workflow - the file will be downloaded if it doesn't already exist
Check out the example workflows containing asset dependencies in the examples folder:
(Drag image to ComfyUI)
- hidream-dev-face.json: ComfyUI workflow that downloads and uses the leading OSS HiDream-I1 Dev model for high quality image generation.
- hidream-fast-crystalball.json: A workflow that downloads and uses the fast version of HiDream-I1 Fast model
- flux1-schnell-cyborg.json: A workflow using the FLUX.1-schnell model from Hugging Face (requires HF_TOKEN)
- epiCRealismXL-sparrow.json: A workflow that downloads the epiCRealism XL model from CivitAI (requires CivitAI token) for realistic image generation.
- dreamshaperXL-forest-woman.json: A workflow using DreamShaper XL from CivitAI
- jibMixRealisticXL-hamster.json: A workflow that uses Jib Mix Realistic XL from CivitAI
- sdxl_lightning-enchantress.json: A workflow that downloads SDXL-Lightning from Hugging Face for fast image generation using SDXL.
- sd3.5_large_fp8-spider.json: A workflow that downloads Stable Diffusion 3.5 Large FP8 model from Hugging Face for a more resource efficient high quality SD 3.5 Large image generation
- wan-image-to-video.json: A workflow that downloads Wan2.1 text-to-video model from Hugging Face for generative videos from an initial image and text prompt.