model-downloader/README.md

ComfyUI Model Downloader

Download models from Hugging Face and Civitai into ComfyUI model folders. Use one YAML config and run on any machine (local, server, rented GPU).

Setup

git clone <repo-url>
cd model-downloader
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
rm config.example.yaml
touch config.yaml

Copy the example config and edit it:

cp config.example.yaml config.yaml

Edit config.yaml: set huggingface_token, civitai_token, comfyui_base_dir, and add model URLs under the right keys. Do not commit config.yaml (it is gitignored).

Run

python -m model_downloader

• --config PATH – config file (default: config.yaml in current directory).
• --dry-run – print what would be downloaded and where; no writes.
• --only TYPE ... – only process these model types (e.g. --only diffusion_models loras).

Config keys and ComfyUI folders

Config key	ComfyUI subdir (under comfyui_base_dir/models/)
diffusion_models	diffusion_models
text_encoders	text_encoders
vaes	vae
upscale_models	upscale_models
loras	loras

Tokens stay in your local config.yaml only; keep them out of git.

Idempotency

Same URL and model type always write to the same path (comfyui_base_dir/models/<subdir>/<filename>). Re-running is safe: existing model files are skipped (no re-download, no overwrite).