ComfyUI 워크플로우 템플릿 기능 상세 가이드

워크플로우 템플릿은 ComfyUI에서 매우 실용적인 기능으로, 다양한 사전 설정된 워크플로우를 탐색하고 사용할 수 있는 편리한 방법을 제공합니다. 이러한 템플릿은 공식적으로 지원되는 모델 워크플로우와 커뮤니티 개발자가 제공하는 예제 워크플로우를 포함합니다.

ComfyUI의 템플릿 시스템에서 다음과 같은 내용을 발견할 수 있습니다:

• 공식 내장 모델 워크플로우 템플릿
• 서드파티 커스텀 노드에서 제공하는 예제 워크플로우

템플릿 기능에 접근하는 방법

워크플로우 템플릿을 열려면 메뉴바에서 워크플로우 —> 워크플로우 템플릿 탐색을 클릭하여 템플릿 탐색 인터페이스에 들어가면 됩니다.

템플릿 사용 가이드

기본 작업 단계

1. 템플릿 선택: 템플릿 목록에서 사용하고 싶은 템플릿을 클릭하면 시스템이 자동으로 해당 워크플로우를 로드합니다
2. 모델 확인: 템플릿을 로드할 때 ComfyUI는 필요한 모델 파일이 설치되어 있는지 자동으로 확인합니다
3. 누락된 모델 다운로드: 필요한 모델 파일이 누락된 것으로 발견되면 시스템이 다운로드를 요청합니다
4. 워크플로우 실행: 모든 요소(모델, 입력 이미지, 프롬프트 등)가 준비되었는지 확인한 후 실행 버튼을 클릭하여 사용을 시작합니다

모델 파일 관리

각 워크플로우 템플릿은 해당하는 모델 정보를 포함하고 있습니다. 첫 사용 시 모델 파일이 누락된 것으로 감지되면 시스템이 다운로드 프롬프트를 표시합니다.

다운로드 방법 설명:

• 데스크톱 버전 사용자: 다운로드 버튼을 클릭한 후 프로그램이 자동으로 모델 파일의 다운로드와 설치를 완료합니다
• 기타 버전 사용자: 브라우저를 통해 모델 파일을 다운로드한 후 수동으로 파일을 올바른 디렉토리에 배치합니다

모델 저장 위치:

스크린샷의 모델을 예로 들어 파일을 다음 위치에 저장해야 합니다:

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── qwen_image_fp8_e4m3fn.safetensors
│   ├── 📂 vae/
│   │   └── qwen_image_vae.safetensors
│   └── 📂 text_encoders/
│       └── qwen_2.5_vl_7b_fp8_scaled.safetensors

중요한 참고사항: 현재 버전의 템플릿 시스템은 모델 파일이 해당하는 1차 디렉토리에 존재하는지만 감지할 수 있습니다. 이미 모델 파일을 하위 폴더에 저장했다면(예: ComfyUI/models/diffusion_models/wan_video) 다운로드 프롬프트를 무시하고 해당하는 모델 로드 노드에서 올바른 모델 파일이 선택되었는지만 확인하면 됩니다.

템플릿 기술 구현 원리

모델 정보 임베딩 메커니즘

템플릿 시스템은 노드의 properties에 models 정보를 추가하여 모델 링크를 임베딩합니다. 다음은 모델 정보를 포함한 DualCLIPLoader 노드의 예시입니다:

    {
      "id": 40,
      "type": "DualCLIPLoader",
      "pos": [
        -320,
        290
      ],
      "size": [
        270,
        130
      ],
      "flags": {},
      "order": 0,
      "mode": 0,
      "inputs": [],
      "outputs": [
        {
          "name": "CLIP",
          "type": "CLIP",
          "links": [
            64
          ]
        }
      ],
      "properties": {
        "Node name for S&R": "DualCLIPLoader",
        "cnr_id": "comfy-core",
        "ver": "0.3.40",
        "models": [
          {
            "name": "clip_l.safetensors",
            "url": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/clip_l.safetensors",
            "directory": "text_encoders"
          },
          {
            "name": "t5xxl_fp16.safetensors",
            "url": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/t5xxl_fp16.safetensors",
            "directory": "text_encoders"
          }
        ]
      },
      "widgets_values": [
        "clip_l.safetensors",
        "t5xxl_fp16.safetensors",
        "flux",
        "default"
      ]
    }

모델 정보 구조 설명

properties에 새로 추가된 models 필드에는 다음 정보가 포함됩니다:

• name: 모델 파일의 이름
• url: 모델 파일의 직접 다운로드 링크(저장소 주소가 아닌 직접 다운로드 가능한 파일 링크여야 함)
• directory: ComfyUI/models 디렉토리 아래의 모델 파일 저장 위치

지원되는 모델 소스: 현재 시스템은 Hugging Face와 CivitAI의 모델 링크를 지원하며, 모델 형식이 안전한 형식(예: .safetensors, .sft 등)이어야 합니다. 안전하지 않은 형식(예: .gguf)은 임베딩 후 안전하지 않은 상태로 표시되며 다운로드 링크가 표시되지 않습니다.

편집 도구: 이 도구를 사용하여 워크플로우 템플릿의 모델 정보를 편집할 수 있지만, 현재 @ComfyUI-Wiki는 네이티브 노드에만 지원을 제공합니다.

템플릿 업데이트 메커니즘

의존성 관리

템플릿 시스템은 독립적인 의존성 패키지를 통해 관리되고 업데이트되며, 해당 패키지 이름은 comfyui-workflow-templates입니다.

ComfyUI를 업데이트한 후 새 문서나 업데이트 노트에서 언급된 템플릿이 누락된 것을 발견한다면, 관련 의존성이 동시에 업데이트되지 않았기 때문일 수 있습니다. ComfyUI/requirements.txt를 확인하여 현재 의존성 버전을 파악할 수 있습니다.

핵심 의존성 패키지: 다음 세 가지 의존성은 일반적으로 각 ComfyUI 업데이트와 함께 동시에 업그레이드됩니다:

comfyui-frontend-package==1.24.4
comfyui-workflow-templates==0.1.52
comfyui-embedded-docs==0.2.4

올바르게 업데이트하는 방법을 확실하지 않다면 ComfyUI 업데이트 챕터를 참조하여 자세한 업데이트 단계를 확인하세요.

커뮤니티 기여 가이드라인

공식 템플릿 기여

모든 공식 템플릿은 workflow_templates 저장소에 호스팅되며, Pull Request를 제출하여 템플릿에 기여할 수 있습니다.

공식 템플릿 요구사항:

1. 순수 네이티브 지원: 누락된 노드로 인해 사용자가 추가 설치가 필요하지 않도록 서드파티 노드를 사용하지 않음
2. 중복 방지: 템플릿이 기존 템플릿과 중복되지 않도록 하고 지원되는 관련 모델 기능이어야 함
3. 문제 피드백: 질문이 있으면 해당 저장소에 issue를 제출하여 토론할 수 있음

커스텀 노드 템플릿

커스텀 노드 개발자가 템플릿과 예제 워크플로우를 제공한다면 템플릿 브라우저에서도 찾을 수 있습니다. 일반적으로 노드 이름에 해당하는 카테고리를 찾으면 개발자가 제공하는 모든 템플릿을 볼 수 있습니다.

개발자 참고사항: 현재 시스템은 템플릿 폴더 아래의 1차 디렉토리 구조만 지원하며, 다단계 디렉토리는 지원하지 않으며 JSON 형식의 템플릿 파일만 지원합니다.

커스텀 노드 템플릿 개발

커스텀 노드에 템플릿 지원을 추가하고 싶다면 커스텀 노드 템플릿 챕터를 참조하여 자세한 개발 프로세스를 이해할 수 있습니다. 또한 커스텀 노드 개발자에게 Pull Request를 제출하여 템플릿 내용에 기여할 수도 있습니다.