Civitai 모델의 메타데이터를 JSON, Markdown 또는 일반 텍스트로 내보내는 간단한 도구입니다.

로컬 모델 라이브러리를 정리하거나 설정을 공유하는 데 완벽합니다.

깨끗하고 우아한 Civitai 모델 정보 내보내기 도구입니다.

깨끗하고 우아한 Civitai 모델 정보 내보내기 도구입니다.

## Vincenzo 소개

Vincenzo는 Civitai 모델 페이지에서 모델 메타데이터와 미리보기 이미지를 추출하도록 설계된 가벼운 유틸리티입니다. 대규모 로컬 모델 컬렉션을 관리하는 사용자들이 자주 겪는 고충을 해결합니다:

Civitai는 로컬 파일을 정리하기 위해 모델 미리보기 및 메타데이터를 일괄 다운로드할 수 있는 간단한 방법을 제공하지 않습니다.

Vincenzo는 이 과정을 매우 간편하게 만들어 줍니다. 웹 UI에 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로 설정하여 프록시 라우팅을 활성화합니다

- 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 모델 페이지 URL>" # URL은 따옴표로 감싸야 합니다

### 2. Gradio UI 모드

python vincenzo.py

이 명령은 인터랙티브 웹 인터페이스를 실행합니다(기본 주소: http://127.0.0.1:7860/).

---

### 문의

질문이나 피드백이 있으시면 아래로 연락주세요:

[email protected]

### 감사의 말

Vincenzo 개발 과정에서 큰 도움을 주신 ChatGPT에게 특별히 감사드립니다.

---

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

⭐️ 이 도구가 도움이 되셨다면 GitHub에서 별을 달아주세요!