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

> 命令行批量下载 Stable Diffusion 模型、LoRA、元数据与示例图，支持 API Key 和自定义分类规则

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

## 核心功能

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

## v2 新增特性

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

## 安装与使用

```bash
pip3 install civitdl
```

**基础用法**：
```bash
# 用模型 ID
civitdl 123456 ./models

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

**配置工具 civitconfig**：
```bash
civitconfig --help
```
可设置默认排序器、最大图片数、API Key 等，无需每次命令行都带参数。

## 适用人群

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

---

**分类**：软件
**标签**：下载 · 数据 · 模型
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1668