Vincenzo - Extracts Civitai model metadata into clean structured formats
詳細
ファイルをダウンロード
このバージョンについて
モデル説明
CivitaiのモデルメタデータをJSON、Markdown、またはプレーンテキストにエクスポートするためのシンプルなツール。
ローカルのモデルライブラリを整理したり、設定を共有したりするのに最適です。
清潔でエレガントなCivitaiモデル情報エクスポートツール。
Vincenzoについて
Vincenzoは、Civitaiモデルページからモデルメタデータとプレビュー画像を抽出するための軽量ユーティリティです。大規模なローカルモデルコレクションを管理するユーザーがよく抱える課題を解決します:
Civitaiには、ローカルでファイルを整理するためにモデルのプレビューとメタデータを一括ダウンロードする簡単な方法がありません。
Vincenzoはこのプロセスを簡単に行います。Web UIにCivitaiモデルのURLを貼り付ける(またはコマンドラインから実行する)だけで、自動的に以下を実行します:
- モデルページから詳細なメタデータを取得
- 最初の有効なプレビュー画像をダウンロード
- 両方を
output/ディレクトリに以下のように保存:
output/<model_name>.png
output/<model_name>.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 に設定してプロキシルーティングを有効化
- "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 UIモード
python vincenzo.py
これにより、対話型Webインターフェースが起動します(デフォルト:http://127.0.0.1:7860/)。
お問い合わせ
ご質問やフィードバックは、以下までお気軽にどうぞ:
謝辞
開発中にChatGPTに多大な助けをいただいたことに心より感謝します。
GitHub: https://github.com/Spr-Peach/Vincenzo
このツールが役に立った場合は、GitHubでスターをつけていただけると幸いです!
