ComfyUI 커스텀 노드(플러그인) 설치 가이드
이 문서에서는 ComfyUI-Manager https://github.com/ltdrdata/ComfyUI-Manager 설치를 예로 들어 설명합니다. ComfyUI 플러그인은 다양하기 때문에 설치 방법과 요구 사항도 다양합니다. 여기서는 가장 일반적인 설치 방법만 설명하겠습니다. ComfyUI Manager는 플러그인 자동 설치, 모델 다운로드 등을 도와주는 실용적인 플러그인입니다. 이 플러그인을 큰 리소스 라이브러리로 간주할 수 있으며, 언제든지 콘텐츠를 다운로드할 수 있습니다. 그러나 중국에 있는 경우 네트워크 접근 문제로 인해 사용이 원활하지 않을 수 있습니다.
- ComfyUI Manager로 설치
- 수동 설치: 압축 패키지에서 ComfyUI 플러그인을 수동으로 설치
- Git 설치: Git 명령어를 사용하여 설치
- aaaki ComfyUI Launcher를 사용하여 커스텀 노드 설치
현재 ComfyUI Desktop에는 ComfyUI Manager 플러그인이 사전 설치되어 있으므로 수동으로 설치할 필요가 없습니다. 네트워크 문제가 없다면 ComfyUI Manager를 사용하여 플러그인을 설치하는 것을 권장합니다.
1. ComfyUI Manager 새 버전 메뉴 위치
그림과 같이 ComfyUI가 올바르게 설치되어 있다면, 최신 버전 메뉴 인터페이스에서 ComfyUI Manager의 위치는 위와 같습니다.
2. ComfyUI Manager 이전 버전 메뉴 위치
설치가 성공하면 ComfyUI 인터페이스를 열었을 때 다음과 같은 화면이 나타납니다(이전 버전)
메뉴 옵션에 새로운 Manager 옵션이 추가되며, 이는 ComfyUI Manager의 진입점입니다.
I. ComfyUI Manager로 플러그인 설치
단계 1: 나타나는 ComfyUI Manager 메뉴에서 Custom Nodes Manager(새 플러그인 설치) 항목을 볼 수 있습니다. 아래와 같이 해당 버튼을 클릭하세요
단계 2: 아래는 해당하는 Custom Nodes Manager 인터페이스입니다
- 위치
1
에서 검색 상자에 설치하려는 플러그인 이름을 입력합니다(예: ComfyUI-Manager) - 위치
2
에서 필요한 플러그인을 찾아 Install 버튼을 클릭하여 설치 - 위치
3
에서 해당 Git 주소를 사용하여 설치할 수도 있습니다 - 설치가 완료될 때까지 기다립니다. 때로는 ComfyUI를 재시작하여 설치를 적용해야 할 수 있습니다
II. Git을 사용한 ComfyUI 플러그인 설치
Git에 익숙하지 않은 경우, GitHub Desktop을 사용한 설치를 추천합니다. GitHub Desktop은 GitHub의 공식 그래픽 git 클라이언트로 매우 사용하기 쉽습니다. 여기서는 두 가지 설치 방법을 소개합니다:
- GitHub Desktop 설치 (Git에 익숙하지 않은 사용자에게 더 친숙함)
- Git 명령줄 설치
1. GitHub Desktop 설치 및 플러그인 업데이트
- 먼저 GitHub 계정을 등록해야 합니다. GitHub 등록 주소: https://github.com/
- 그런 다음 GitHub Desktop을 다운로드합니다: https://desktop.github.com/
- 다운로드 및 설치가 완료되면 소프트웨어를 열고 계정 로그인을 완료합니다
GitHub Desktop을 사용한 플러그인 설치 단계는 다음과 같습니다:
File
메뉴를 클릭하고Clone repository
를 선택합니다
2. 팝업 창에서 URL을 사용한 Clone 방법을 선택합니다
3. 플러그인을 설치할 디렉토리를 선택합니다. 일반적으로 ComfyUI 설치 폴더의
custom_nodes
디렉토리입니다. 스크린샷에서는 D:\ComfyUI_windows_portable\ComfyUI\custom_nodes
로 설정했습니다
“This folder contains files. Git Can only clone empty folders”라는 메시지가 표시될 수 있습니다. 이는 걱정하지 않아도 됩니다. GitHub 저장소 주소를 입력하면 이 메시지는 업데이트되고 사라집니다
4. URL 입력란에 설치하려는 플러그인의 Git 저장소 주소를 입력합니다(예: https://github.com/kijai/ComfyUI-Hunyuan3DWrapper). 주소를 입력하면 설치 디렉토리도 업데이트됩니다
5.
Clone
버튼을 클릭하고 설치가 완료될 때까지 기다립니다
ComfyUI를 재시작하고 필요한 종속성 설치가 완료될 때까지 기다립니다. 이것으로 플러그인 설치가 완료됩니다.
위의 스크린샷에서 볼 수 있듯이, Git Desktop을 사용하여 여러 작성자의 git 저장소를 설치했습니다
- 위치 1을 클릭하면 GitHub Desktop으로 설치한 git 저장소 주소가 열립니다
- 플러그인에 업데이트가 있는 경우 위치 2와 같은 화살표 표시가 나타납니다
- 해당 메뉴를 클릭하여 저장소로 전환하면 위치 3과 같은 업데이트 알림이 표시됩니다.
Pull Origin
버튼을 클릭하여 플러그인을 업데이트합니다
2. Git 명령줄 설치
- Git 소프트웨어 다운로드: https://git-scm.com/
먼저 설치하려는 플러그인의 Git 저장소를 찾습니다. 예: https://github.com/ltdrdata/ComfyUI-Manager
- 페이지에서 녹색 <>code 버튼을 클릭합니다.
- 팝업 창에서 https 옵션의 입력 상자 뒤에 있는 복사 버튼을 클릭합니다.
- 링크 https://github.com/ltdrdata/ComfyUI-Manager.git 를 복사합니다.
- CMD 터미널을 열고, 먼저
cd
명령어를 사용하여 ComfyUI 플러그인이 있는 폴더로 이동합니다. 예를 들어 E://ComfyUI_windows_portable/COmfyUI/custom_nodes
cd E://ComfyUI_windows_portable/COmfyUI/custom_nodes
그런 다음 git clone 명령어를 사용하여 해당 코드 저장소를 복제합니다
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
- 성공 알림을 기다립니다.
- ComfyUI를 재시작하여 플러그인이 성공적으로 설치되었는지 확인합니다.
참고: 국내 환경에서 GitHub를 사용하는 것은 실패로 이어질 수 있습니다. 성공률을 높이기 위해 해당 플러그인 저장소를 Gitee와 같은 국내 코드 저장소에 동기화할 수 있습니다.
III. 수동 설치: ZIP 패키지에서 ComfyUI 플러그인 설치
먼저 해당 저장소 주소를 방문하세요: https://github.com/ltdrdata/ComfyUI-Manager
일반적으로 수동 설치를 권장하지 않습니다. 이 과정에서 Git 저장소 정보가 손실될 수 있으며, 많은 플러그인이 자주 업데이트되므로 수동 설치 업데이트는 Git 설치만큼 편리하지 않을 수 있습니다.
- 저장소에는 일반적으로 Readme에 설치 지침이 제공되며, 이를 따라 설치할 수 있습니다
- 페이지에서 녹색 <>code 버튼을 클릭합니다.
- 팝업 창에서 Download ZIP 버튼을 클릭합니다.
- 다운로드 후 압축 패키지를 해제합니다.
- 해제된 폴더를
comfyui/custom_nodes
플러그인 디렉토리에 복사합니다. - ComfyUI를 재시작하고 플러그인이 설치되었는지 확인합니다.
IV. aaaki ComfyUI Launcher 플러그인 설치
aaaki ComfyUI Launcher를 사용하는 경우, 중국 국내 환경에서 설치 성공률이 훨씬 높아집니다.
- ComfyUI가 실행 중이지 않은지 확인합니다
- aaaki ComfyUI Launcher에서
Version Management\Install Extension
을 선택합니다 (아래 그림은 영어 버전 인터페이스를 사용합니다) - 설치하려는 플러그인을 검색하거나 찾아서 설치를 클릭합니다
- 플러그인이 없는 경우, 이 인터페이스의
Extension URL
을 사용하여 해당 플러그인 git 주소를 입력하여 git을 통해 설치할 수 있습니다
하지만 최근 중국 내 GitLab 접근 문제로 인해 이 방법의 성공률이 낮아질 수 있습니다. VPN을 사용하거나 GitHub 저장소를 Gitee에 미러링한 후 git 명령어를 사용하여 설치하는 것을 권장합니다.