Civitai Companion: 자동 메타데이터 추출 및 리소스 관리를 통한 AI 이미지 워크플로우 간소화

Civitai Companion은 Civitai.com에서 생성된 AI 이미지를 다루는 과정을 간소화하기 위해 설계된 강력한 유틸리티입니다. 이 도구는 AI 아티스트와 애호가의 요구를 충족시키기 위해 프롬프트 메타데이터의 자동 추출, 필요한 리소스 다운로드 및 다양한 AI 이미지 생성 도구에서 사용할 수 있도록 정보 형식을 조정합니다. 원래 Dream Factory의 동반자로 구상된 Civitai Companion은 유연한 템플릿 시스템을 통해 Automatic1111 등 여러 플랫폼을 지원하도록 발전했습니다.

Civitai Companion은 AI 이미지 워크플로우를 향상시키기 위한 강력한 기능 세트를 제공합니다: 1. 배치 메타데이터 추출: Civitai 이미지와 Dream Factory 창작물에서 프롬프트 및 관련 메타데이터를 효율적으로 추출합니다. 2. 자동 리소스 다운로드: 이미지 생성을 위해 필요한 모델, LoRA 및 임베딩을 다운로드하며, 파일 형식 및 크기에 대한 사용자 정의 옵션을 제공합니다. 3. 사용자 정의 출력 형식: 템플릿 기반 시스템을 사용하여 추출된 정보를 사용자 지정 형식으로 출력합니다. 4. LoRA 경로 최적화: LoRA 참조를 자동으로 수정하여 로컬 경로 구조에 맞춥니다. 5. 메타데이터 값 조정: 특정 프롬프트 메타데이터에 대한 최소/최대 값을 설정할 수 있어 설정과의 호환성을 보장합니다. 6. 콘텐츠 필터링: 원하지 않는 단어 또는 LoRA를 프롬프트에서 자동으로 제거하는 옵션을 제공합니다. 7. 이미지 크기 최적화: 이미지의 종횡비를 유지하면서 기본 모델의 가장 가까운 '공식' 해상도로 크기를 조정합니다. 8. 샘플러 이름 변환: Automatic1111과 같은 도구에 호환되는 대체 이름으로 지원되지 않는 샘플러 이름을 변환합니다.

Civitai Companion 설정은 간단합니다: 1. 요구 사항: 작동하는 Python 환경 (3.10에서 테스트됨). 2. 설치: - 저장소 복제: `git clone https://github.com/rbbrdckybk/civitai-companion` - 디렉토리로 이동: `cd civitai-companion` - 필요한 패키지 설치: `pip install --no-input requests tqdm pillow` 이미 Dream Factory를 사용 중이라면 패키지 설치 단계를 건너뛸 수 있습니다.

Civitai Companion을 사용하려면: 1. 스크립트 실행: `python civitai_reader.py --config_file config-example.txt` 2. 도구가 샘플 이미지를 스캔하고, 메타데이터를 추출하며, 참조된 LoRA를 다운로드하고, 출력 파일을 생성합니다. 3. 전체 기능을 사용하려면 Civitai API 키를 얻어 구성 파일에 추가합니다. 4. 필요에 맞게 구성 파일에서 설정을 사용자 정의합니다. 도구는 이미지를 처리하고, 리소스를 다운로드하며, 구성 및 선택한 템플릿에 따라 출력 파일을 생성합니다.

Civitai Companion은 출력을 형식화하기 위해 유연한 템플릿 시스템을 사용합니다. 주요 토큰은 다음과 같습니다: - [PROMPT]: 이미지에 사용된 긍정적 프롬프트 - [NEG_PROMPT]: 부정적 프롬프트 - [MODEL]: 사용된 모델 - [SEED], [SAMPLER], [CLIP_SKIP], [WIDTH], [HEIGHT], [SCALE], [STEPS]: 다양한 생성 매개변수 - [BASE_MODEL]: 기본 모델 (예: SDXL 1.0, SD 1.5) - [FILENAME], [FILEPATH]: 원본 이미지 파일 정보 사용 가능한 토큰 및 형식 옵션의 전체 목록은 template-example.txt 파일을 참조하십시오.

Civitai Companion을 최대한 활용하려면: 1. 명령줄 인수를 사용하여 특정 워크플로우에 대한 구성 파일 설정을 재정의합니다. 2. 로그 폴더의 log.txt 파일에서 자세한 실행 정보 및 문제 해결을 확인합니다. 3. 캐시 폴더의 do_not_download.txt 파일을 편집하여 리소스 블랙리스트 관리를 수행합니다. 4. civitai_version_ids.txt 파일을 활용하여 특정 리소스의 버전 ID를 찾습니다. 이러한 고급 기능은 Civitai Companion 워크플로우의 세밀한 제어 및 사용자 지정을 가능하게 하여 AI 이미지 생성 프로세스를 효율적으로 최적화할 수 있습니다.