ComfyUI模型下载器是一个专门用于从HuggingFace和CNB.Cool仓库下载ComfyUI模型的Python工具。支持Git LFS大文件下载、断点续传、智能文件夹映射等功能。

• 支持HuggingFace和CNB.Cool两种仓库类型
• 智能Git LFS下载，自动处理CNB.Cool的hash提取
• 只下载split_files文件夹下的模型文件，自动过滤README.md、.gitattributes等非模型文件
• 自动将文件映射到正确的ComfyUI文件夹结构
• 支持大文件下载和断点续传
• 实时显示下载进度和速度

pip install requests tqdm huggingface_hub

pip install -r requirements.txt

python comfyui_model_downloader.py <仓库地址>

1. HuggingFace仓库：

   python comfyui_model_downloader.py https://huggingface.co/Comfy-Org/z_image_turbo
   

2. CNB.Cool仓库：

   python comfyui_model_downloader.py https://cnb.cool/ai-models/Comfy-Org/z_image_turbo
   

下载z_image_turbo模型：

python comfyui_model_downloader.py https://cnb.cool/ai-models/Comfy-Org/z_image_turbo

下载器会自动将文件映射到正确的ComfyUI文件夹：

源路径	目标路径
split_files/diffusion_models/	models/diffusion_models/
split_files/clip/	models/clip/
split_files/text_encoders/	models/text_encoders/
split_files/vae/	models/vae/
split_files/unet/	models/unet/

CNB.Cool使用特殊的Git LFS机制，下载器会：

1. 访问blob页面提取SHA256哈希值
2. 构建正确的LFS下载URL
3. 进行文件下载

只下载以下类型的文件：

• .safetensors 文件
• .bin 文件
• .pth 文件
• .pt 文件

自动排除：

• README.md
• .gitattributes
• 其他非模型文件

• 网络连接失败会自动重试
• 支持断点续传，下载中断后可继续
• 详细的错误日志输出

1. 确保有足够的磁盘空间（模型文件通常很大）
2. 稳定的网络连接对于大文件下载很重要
3. 首次下载可能需要较长时间，请耐心等待

下载器会实时显示：

• 当前下载的文件名
• 下载进度条
• 下载速度
• 已用时间
• 剩余时间估算
• 总体下载进度

完成后会显示下载统计信息，包括总文件数、总大小、总用时等。