kijai/ComfyUI-KJNodes

ComfyUI‑KJNodes 는 무엇인가요?

ComfyUI‑KJNodes 는 ComfyUI (Stable Diffusion 및 기타 생성형 AI 파이프라인을 구축하는 시각적 노드 기반 인터페이스)용 플러그인입니다. 이 리포지토리는 대규모 그래프를 조직하고 최적화하며 디버깅하기 쉽게 해주는 추가 노드와 UI 헬퍼를 제공합니다.

핵심 개념

기능	설명 (일반적인 언어로)
유용성 / QoL 노드	일반적인 작업(예: 값 설정/읽기, 링크 변환)을 수행하는 작은 블록으로, 반복적인 연결 패턴을 다시 만들지 않아도 됩니다.
모델 최적화 도우미	무거운 외부 라이브러리를 불러오지 않고도 모델 파라미터를 조정하거나 결과를 캐시할 수 있습니다.
최소한의 종속성	`requirements.txt` 에 나열된 패키지만 필요하며, 설치가 가볍습니다.
서브그래프 인식	Set/Get 노드는 중첩된 그래프 간에 작동합니다. 부모 그래프에서 설정한 값은 자식 서브그래프 어디서든 읽을 수 있으며, UI에서 쉽게 이동할 수 있습니다.
키보드 단축키 및 마우스 제스처	D(노드 삽입), S(노드 교체), Ctrl+Shift+S/G/L(빠른 Set/Get 생성), 중간 클릭 단축키 등으로 그래프 편집이 빨라집니다.
시각적 링크 토글	Set/Get 쌍으로 생성된 가상 연결은 필요에 따라 표시 또는 숨길 수 있어 캔버스의 가독성을 유지합니다.
캔버스 확장 기능	오른쪽 클릭 메뉴를 통해 직접 연결과 Set/Get 쌍 간 변환, 여러 노드 일괄 변환, 연결 메뉴에서 Set/Get 노드 직접 추가가 가능합니다.

설치 방법

ComfyUI 설치 폴더의 custom_nodes 폴더에 리포지토리를 클론합니다.
pip install -r requirements.txt 를 실행합니다 (또는 README에 표시된 포터블 설치 명령어를 사용합니다).
ComfyUI를 재시작하면 새로운 노드가 KJNodes 카테고리에 나타납니다.

최근 주요 업데이트 (2026년 3월 19일)

작성자가 Set/Get 시스템을 완전히 재작성하여 호환성 유지와 새로운 Nodes 2.0 형식 지원을 달성했습니다. 주요 기능은 다음과 같습니다:

Set/Get 값의 서브그래프 간 가시성 향상.
오른쪽 클릭을 통한 링크와 Set/Get 쌍 간 변환.
여러 출력을 한 번에 일괄 변환하는 기능.
기본 위젯 값, 타입 추론, 링크 가시성 모드에 대한 새 설정.
복제된 노드를 붙여넣을 때의 이름 변경 처리 개선.

누가 이 도구를 사용할 수 있을까?

아티스트 및 프롬프트 엔지니어 – 복잡한 Stable Diffusion 워크플로우를 구축하고, 여러 노드 간에 상수(예: 모델 이름, 시드)를 깔끔하게 공유하고 싶은 사람.
연구자 – 새로운 파이프라인 단계를 빠르게 프로토타이핑하고, 그래프를 더럽히지 않고도 쉽게 재연결하고 싶은 사람.
고급 사용자 – ComfyUI 캔버스에서 오랜 시간을 보내며 단축키, 시각적 신호, 서브그래프 탐색 기능을 좋아하는 사람.

제한 사항

이 플러그인은 UI/그래프 관리 기능만 추가합니다. 새로운 확산 모델이나 추론 엔진은 제공하지 않습니다.
기능은 대상 ComfyUI 버전에 종속되어 있습니다. ComfyUI의 핵심 API가 크게 변경되면 노드 업데이트가 필요할 수 있습니다.

TL;DR: ComfyUI‑KJNodes 는 가볍고 종속성이 적은 확장 기능으로, ComfyUI 사용자에게 풍부한 유틸리티 노드, 서브그래프 간 스마트한 Set/Get 처리, 그리고 대규모 AI 생성 그래프를 정리하고 편집하기 쉽게 해주는 다양한 키보드/마우스 단축키를 제공합니다.