Vincenzo - Extracts Civitai model metadata into clean structured formats

namiachynamiachy
2
7
工具
v1.0

详情

下载文件

模型描述

一个简单的工具，用于将任何 Civitai 模型的元数据导出为 JSON、Markdown 或纯文本。

非常适合组织本地模型库或分享配置。

一款简洁优雅的 Civitai 模型信息导出器。

关于 Vincenzo

Vincenzo 是一款轻量级工具，专为从 Civitai 模型页面 提取关键信息而设计——包括模型元数据和预览图像。它解决了经常维护大量本地模型集合的用户所面临的一个常见痛点：

Civitai 并未提供一种简便方式来批量下载模型预览图和元数据以进行本地文件整理。

Vincenzo 让这一过程变得轻而易举。只需将 Civitai 模型 URL 粘贴到网页界面中（或通过命令行运行），它将自动执行以下操作：

  • 从模型页面获取详细元数据
  • 下载第一个有效的预览图像
  • 将这两项内容保存至 output/ 目录中，格式如下：

output/.png
output/.txt

TXT 文件中包含什么？

每个导出的 .txt 文件都包含了从 Civitai 模型页面捕获的所有结构化相关信息，包括：

- 类型（例如：LoRA、Checkpoint、LoCon 等）
- 发布日期
- 基础模型
- 触发词 / 使用提示
- 哈希信息
- 实际模型文件的文件名
- 模型页面的源 URL

这确保了即使不打开 Civitai 网站，你也能随时获得一份易于阅读的模型参考信息。

推荐工作流程

在导出多个模型后，建议将生成的 .png 和 .txt 文件移动到你本地存储对应模型文件的同一目录中。

这样可以保持你的模型文件夹整洁有序，极大地方便浏览。

默认图像行为

如果某个模型页面没有预览图像，Vincenzo 将自动使用内置的 default.png 作为占位符。

这确保了每次导出都包含一个可用的预览图像，防止你的模型库中出现缩略图缺失的情况。

代理配置（可选）

如果你通过代理访问 Civitai，可以在 config.json 文件中进行配置：

{
"enable_proxy": true,
"proxy_host": "127.0.0.1",
"proxy_port": 7890
}

- 将 "enable_proxy": true 设为 true 以启用代理路由
- 根据你的本地代理设置调整 "proxy_host" 和 "proxy_port"
- 当禁用时，所有网络请求将正常运行，不经过代理

安装

1. 克隆仓库

git clone https://github.com/Spr-Peach/Vincenzo.git
cd Vincenzo

2. 创建并激活虚拟环境

（推荐：Python 3.11 或更高版本）

a. 使用 Python venv

python3.11 -m venv vincenzo
source vincenzo/bin/activate # macOS/Linux
vincenzo\Scripts\activate # Windows

b. 使用 Conda

conda create -n vincenzo python=3.11
conda activate vincenzo

3. 安装依赖

pip install -r requirements.txt

运行

1. 命令行模式

python vincenzo.py "<civitai model page url>" # 请保留 URL 的引号

2. Gradio 界面模式

python vincenzo.py

这将启动交互式网页界面（默认地址：http://127.0.0.1:7860/）。

联系方式

如有任何问题或反馈，欢迎联系：

[email protected]

致谢

特别感谢 ChatGPT 在 Vincenzo 开发过程中提供的宝贵帮助。

GitHub: https://github.com/Spr-Peach/Vincenzo

如果你觉得这个工具很有帮助，欢迎在 GitHub 上点个星标支持！

此模型生成的图像

未找到图像。