civitdl - Civitai 模型批量下载 CLI 工具

civitdl 是一款命令行工具，专为从 Civitai 批量下载 Stable Diffusion 模型而设计。支持 Checkpoint、LoRA、Textual Inversion 等多种模型类型，同时自动拉取模型元数据和示例图片，方便本地管理。

核心功能

• 批量下载 — 支持同时下载多个模型，可通过模型 ID 或 Civitai 链接指定目标
• 多类型支持 — Checkpoint、LoRA、Textual Inversion 全覆盖
• 自动下载元数据 — 模型描述、作者信息、基础模型、示例 Prompt 等
• 示例图片 — 默认下载 3 张示例图（可配置），支持并发下载
• 重试机制 — 下载失败时自动重试
• 跳过已存在 — 检测本地缓存，避免重复下载

v2 新增特性

• API Key 支持 — 可下载受限模型（需要登录才能下载的内容）
• 自定义排序器（Sorter） — 灵活配置模型、元数据、图片的存储路径规则
• 别名（Alias） — 为常用模型或路径设置简短别名
• 快速请求 — 优化了网络请求速度
• 图片元数据隔离 — 每张示例图的 Prompt/ 元数据单独存储

安装与使用

pip3 install civitdl

基础用法：

# 用模型 ID
civitdl 123456 ./models

# 用 Civitai 链接
civitdl https://civitai.com/models/123456 ./models

配置工具 civitconfig：

civitconfig --help

可设置默认排序器、最大图片数、API Key 等，无需每次命令行都带参数。

适用人群

• 经常从 Civitai 下载大量模型的 Stable Diffusion 本地用户
• 需要自动化备份模型和元数据的玩家
• 想通过脚本/工作流管理模型库的进阶用户