comfy-asset-downloader

Comfy Asset Downloader

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.

Features

• 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

Installation

Using ComfyUI Manager

Search and install Comfy Asset Downloader from ComfyUI's Manager Custom Nodes Manager.

Using Git

git clone https://github.com/ServiceStack/comfy-asset-downloader \
    ComfyUI/custom_nodes/comfy-asset-downloader

Configure Environment Variables (Optional)

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

Description

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.

Usage

1. Add an AssetDownloader node to your workflow
2. Set the URL to a model file (e.g., https://huggingface.co/model-repo/resolve/main/the_model.safetensors)
3. Choose the appropriate save location (e.g. checkpoints)
4. Set the filename (e.g., the_model.safetensors)
5. Run the workflow - the file will be downloaded if it doesn't already exist

Example ComfyUI Workflows

Check out the example workflows containing asset dependencies in the examples folder:

(Drag image to ComfyUI)

HiDream

• 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

Flux

• flux1-schnell-cyborg.json: A workflow using the FLUX.1-schnell model from Hugging Face (requires HF_TOKEN)

Stable Diffusion

• sdxl_lightning-enchantress.json: A workflow that downloads SDXL-Lightning from Hugging Face for fast image generation using SDXL
• sdxl_base_refiner-bottle.json: A workflow that downloads SDXL Base and SD XL Refiner from Hugging Face for an image generation example using a base model with a refiner
• sdxl-base_refiner_sytan-tiger.json: A more complex SDXL Base and SD XL Refiner workflow from @SytanSD
• sdxl_turbo1-fox.json: A workflow that downloads SDXL Turbo v1.0 from Hugging Face for basic image 512x512 generation
• [sd3.5_large_fp8-spider.json](./e