download_model
Download model files from URLs into the correct ComfyUI models subfolder, supporting HuggingFace, HTTP, S3, and Azure Blob with optional authentication.
Instructions
Download a model file to the connected ComfyUI's models directory from a URL (HuggingFace, direct HTTP(S), s3://, or Azure Blob). PREFER this over a raw shell download (curl/wget) for model weights: it lands the file in the right models/ subfolder. LOCAL ComfyUI: streams to disk and surfaces live progress in the panel download tray. REMOTE ComfyUI: dispatches the fetch to the ComfyUI host via the ComfyUI-Manager install-model HTTP API (downloaded server-side; a per-request auth header can't be forwarded). This requires the host's Manager to run with network_mode=personal_cloud (or loopback) and a permissive security level — a stricter gate silently rejects the download, and Manager reports the queue task 'done' even on failure, so a remote dispatch does not guarantee the file landed. target_subfolder accepts any relative subfolder (incl. nested, e.g. 'loras/').
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Direct download URL for the model file | |
| auth | No | Optional per-request authentication for private/gated model URLs. When provided it overrides built-in HuggingFace/CivitAI token handling. | |
| filename | No | Override filename (auto-detected from URL if omitted) | |
| target_subfolder | Yes | Target subfolder under ComfyUI models/. Standard names: checkpoints, loras, vae, upscale_models, controlnet, embeddings, clip, diffusers, diffusion_models, gligen, hypernetworks, photomaker, style_models, text_encoders, unet. Any other relative subfolder (incl. nested like 'loras/<subdir>') is allowed; absolute paths and '..' escapes are rejected. |