Comfy-Org/ComfyUI-Manager

ComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.

ComfyUI‑Manager 는 무엇인가요?

ComfyUI‑Manager는 오픈소스 시각 프로그래밍 도구 ComfyUI (Stable-Diffusion 이미지 생성 파이프라인용 UI)용 확장 기능입니다. 이 매니저는 사용자가 UI를 떠나지 않고도 사용자 정의 노드 패키지 및 모델 파일의 설치, 업데이트, 활성화/비활성화, 제거를 할 수 있도록 그래픽적 "Manager" 패널을 추가합니다.

왜 중요한가요?

사용자 정의 노드 생태계 – ComfyUI의 힘은 커뮤니티가 만든 "노드"(Python 플러그인)에 있습니다. 이들은 새로운 이미지 처리 단계를 구현합니다. 수십 개의 노드 리포지토리를 추적하는 것은 번거로울 수 있지만, 매니저를 통해 중앙에서 발견하고 설치할 수 있습니다.
원클릭 설치 – 공식 레지스트리(https://registry.comfy.org/) 또는 로컬 캐시에서 가져온 커리레이티드 목록을 둘러보고, Install 또는 Try Install을 클릭하여 노드 리포지토리를 복제하고, Python 종속성 설치 후 즉시 UI에서 사용할 수 있게 됩니다.
모델 관리 – 동일한 UI는 대용량 모델 파일(예: .ckpt, .safetensors)을 다운로드하고 올바른 폴더에 배치하는 기능도 지원합니다.
안전성 및 재현성 – 스크린샷은 설치된 노드/모델의 정확한 세트를 기록하여, 나중에 알려진 작동 환경으로 복원할 수 있습니다.
CLI 도구 (cm-cli) – 파워 유저는 명령줄에서 동일한 작업을 스크립트로 실행할 수 있으며, 자동화된 설정이나 헤드리스 서버에 유용합니다.

핵심 기능 (README에 설명됨)

기능	설명
사용자 정의 노드 설치/제거/활성화/비활성화	노드 리포지토리를 가져오고, 선택적 `install.py`/`requirements.txt`를 실행하며, ComfyUI에 등록합니다.
모델 설치기	모델 파일(.ckpt, .safetensors 등)을 설정 가능한 디렉터리에 다운로드합니다.
허브/채널 시스템	세 가지 데이터베이스 모드 – 채널(1일 캐시), 로컬, 채널(원격) – 노드 목록의 출처와 최신성 여부를 제어합니다.
스크린샷 매니저	현재 설치된 노드/모델 세트를 스크린샷 파일로 저장할 수 있으며, 다음 ComfyUI 시작 시 복원할 수 있습니다.
워크플로우 공유	현재 워크플로우를 comfyworkflows.com, openart.ai, youml.com 또는 Matrix와 같은 외부 사이트에 1클릭으로 공유할 수 있습니다.
컴포넌트 공유	재사용 가능한 노드 그룹("컴포넌트")을 JSON 또는 `.pack` 파일로 복사/붙여넣기 또는 드래그/드롭하여 공유할 수 있습니다.
누락된 노드 도우미	워크플로우에서 참조되지만 설치되지 않은 노드를 감지하고, 필요한 사용자 정의 노드 설치를 제안합니다.
사용자 설정 가능한 동작	`config.ini`를 통해 git 경로, pip vs. uv 선택, 보안 수준, 네트워크 모드(공개/비공개/오프라인), 사용자 정의 pip 오버라이드/블랙리스트 등을 설정할 수 있습니다.
CLI (`cm-cli`)	UI를 시작하지 않고도 동일한 설치/업데이트 기능을 제공합니다.
보안 패치 (v3.38)	매니저 데이터는 보호된 사용자 디렉터리(`<USER_DIRECTORY>/__manager/`)에 저장되어 실수로 수정되는 것을 방지합니다.
환경 변수 오버라이드	`COMFYUI_PATH`, `GITHUB_ENDPOINT`, `HF_ENDPOINT`를 사용하여 매니저를 미러 또는 사용자 정의 설치로 지정할 수 있습니다.

사용 방법

확장 기능 설치 – 리포지토리를 ComfyUI/custom_nodes/comfyui-manager에 클론하거나 제공된 포터블 설치 스크립트 또는 comfy-cli 헬퍼를 사용합니다. ComfyUI를 재시작합니다.
매니저 열기 – 상단 메뉴바에 새로운 "Manager" 버튼이 나타납니다.
노드/모델 탐색 – 채널 모드를 선택한 후, 원하는 항목의 Install 또는 Try Install을 클릭합니다.
스크린샷 저장 – 워크플로우를 설정한 후 Save snapshot을 클릭합니다. 나중에 Restore를 통해 변경 사항을 되돌릴 수 있습니다.
공유 – 공유 버튼을 클릭하여 워크플로우를 외부 사이트에 업로드하거나 JSON 팩을 복사합니다.
CLI – cm-cli <command>를 실행합니다 (자세한 내용은 docs/en/cm-cli.md 참조) 스크립트 기반 설치 또는 일괄 업데이트를 수행합니다.

누구를 위한 것인가요?

ComfyUI로 이미지 생성 파이프라인을 구축하는 아티스트 및 취미가, 커뮤니티 노드를 쉽게 추가하고 싶은 사람.
사용자 정의 노드 개발자 – 노드 메타데이터(custom-node-list.json)를 제출하여 매니저에 등재할 수 있습니다.
파워 유저/시스템 관리자 – CLI 및 스크린샷 기능을 통해 여러 머신 또는 CI 파이프라인에서 동일한 환경을 쉽게 프로비저닝할 수 있습니다.

제한 사항 / 주의사항

매니저는 ComfyUI 버전 ≥ 0.3.76 에서만 작동합니다 (이전 버전은 백업 경로 있음). 오래된 ComfyUI 릴리스는 확장 기능을 수동으로 배치해야 합니다.
종속성 설치는 호스트의 Python 환경에 의존합니다. 네트워크 제한 환경(network_mode=offline)에서는 캐시된 데이터만 사용됩니다.
스크린샷 복원은 Git 추적되지 않은 사용자 정의 노드에는 완전히 대응하지 않습니다. 이러한 노드는 수동으로 재설치해야 할 수 있습니다.

빠른 시작 체크리스트

작동 가능한 ComfyUI 설치 확인 (Python 3, Git).

매니저를 클론합니다:

cd path/to/ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager

ComfyUI 재시작 → Manager 클릭 → 노드 목록 탐색.
(옵션) use_uv = true를 config.ini에 설정하여 더 빠른 uv 설치기 사용.
(옵션) channels.list 조정 또는 내부 노드 리포지토리용 개인 채널 생성.

요약하면: ComfyUI‑Manager는 기능이 풍부하고 보안 인식이 높은 확장 기능으로, 커뮤니티가 만든 노드와 모델 파일을 찾고 설치하며 관리하는 일반적으로 수작업으로 이루어지는 프로세스를 매끄럽고 클릭 기반의 경험으로 바꾸며, 공유, 스크린샷, 명령줄 자동화를 위한 추가 도구를 제공합니다.