WASasquatch/was-node-suite-comfyui

WAS-NS v3 Reborn; Tools for image processing, filters, masking, text, logic, numbers, latents, files, 3D scenes, and animation.

WAS Node Suite v3란 무엇인가요?

WAS Node Suite(WAS‑NS)는 Stable Diffusion 스타일 이미지 생성 파이프라인을 구축하고 실행하는 데 사용되는 시각적 워크플로 도구인 ComfyUI용 커스텀 노드 모음입니다. 이 스위트는 532개의 바로 사용 가능한 노드를 추가하며, 이미지 필터링, 색상 보정, 마스킹, 텍스트 처리, 로직 흐름, 파일 I/O, 애니메이션, 비디오, 그리고 몇 가지 모델 관련 헬퍼까지 광범위한 작업을 다룹니다. 요컨대, Python 코드를 작성하지 않고도 ComfyUI를 완전한 기능을 갖춘 그래픽 처리 도구 상자로 바꿔줍니다.

누가 사용할까요?

아티스트 및 크리에이터: ComfyUI에서 이미지‑투‑이미지 또는 텍스트‑투‑이미지 워크플로를 구축하고 더 많은 즉시 사용 가능한 작업(예: 얼굴 감지, 그라디언트 맵, 비디오 프레임 보간)을 원하는 사람.
교육자 및 취미 사용자: 생성형 AI 파이프라인을 가르치거나 실험하기 위해 대규모 노드 라이브러리가 필요한 사람.
개발자: 상용 서비스에 확장하거나 포함할 수 있는 안정적이고 MIT 라이선스 기반을 원하는 사람.

주요 기능(README에 설명된 대로)

영역	스위트가 제공하는 것
노드 수	48개 카테고리에 걸쳐 532개 노드(마스킹, 레이어, 색상/LUT, HDR, 로직, 숫자, 텍스트, 프롬프트, 파일, 애니메이션, LoRA 등).
필수 종속성 없음	`ComfyUI/custom_nodes`에 클론한 후 ComfyUI 0.14+ 및 Python 3.10+만 있으면 작동합니다. 자동으로 pip 설치가 수행되지 않습니다.
선택적 기능 그룹	`config.yaml`에서 22개의 토글 가능한 그룹; 8개는 기본적으로 비활성화(예: 문서 내보내기, 네트워크 집약적 모델).
내장 타사 자산	글꼴, three.js, 얼굴 캐스케이드 파일, 여러 사전 훈련된 네트워크 및 기타 라이브러리를 번들로 제공 – 모두 허용적 라이선스 하에 있으며 런타임 다운로드 없음.
보안 우선	아웃바운드 네트워크 호출은 기본적으로 비활성화; 파일 액세스는 허용 목록으로 제한.
업그레이드 경로	이전 버전에 저장된 워크플로와 호환; README에는 폐기되거나 제거된 노드 ID가 처리되는 방법이 나열되어 있습니다.
문서 내보내기(선택 사항)	`document_export` 그룹을 활성화하면 워크플로에서 직접 `.docx`, `.odt` 또는 `.pdf` 파일을 작성할 수 있습니다.
Three.js 장면 지원	three.js를 사용하여 대화형 3‑D 장면을 렌더링하는 노드; 안전을 위해 구성 플래그로 실행이 제한됩니다.
모델 가중치 처리	`features.network`를 활성화하지 않는 한 가중치가 다운로드되지 않습니다. 활성화하면 스위트가 포함된 소수의 번들 모델 파일을 가져올 수 있습니다.

설치 방법

ComfyUI Manager를 통해 – WAS Node Suite v3를 검색하고 설치를 클릭합니다(권장).
수동으로 – 저장소를 ComfyUI/custom_nodes에 클론합니다:
```
cd ComfyUI/custom_nodes
git clone https://github.com/WASasquatch/was-node-suite-comfyui.git
```
스위트는 ComfyUI 0.14+ 및 Python 3.10+와 함께 작동합니다. 선택적 그룹(예: document_export)을 활성화하지 않는 한 추가 pip 명령이 필요하지 않습니다.

버전 3 대비 버전 2의 새로운 점은 무엇인가요?

노드 수가 두 배 이상 – 220개에서 532개로 증가.
기본 외부 패키지 없음 – v2는 약 20개의 패키지를 설치했지만 v3는 옵트인하지 않는 한 아무것도 설치하지 않습니다.
선택적 기능 그룹 – config.yaml을 통해 전체 카테고리를 활성화/비활성화할 수 있습니다.
업데이트된 타사 자산 – 이제 three.js, 글꼴, 얼굴 캐스케이드 및 몇 가지 사전 훈련된 네트워크가 포함됩니다.
개선된 노드 동작 – 많은 노드가 ComfyUI의 장치에서 완전히 실행되도록 다시 작성되었으며(OpenCV, 추가 라이브러리 없음), 여러 노드에 더 풍부한 옵션이 있습니다(예: 더 많은 블렌드 모드, 더 나은 그레인 처리).

구성 및 확장성

config.yaml 파일은 첫 실행 시 <ComfyUI 사용자 디렉터리>/was-node-suite/ 아래에 생성됩니다. config.example.yaml을 미러링하며 22개의 기능 그룹을 토글하고, 네트워크 다운로드를 활성화하거나, 보안 허용 목록을 조정할 수 있습니다.
노드는 동일한 구성을 통해 노드별로 비활성화할 수 있으며, 프로덕션 환경을 간소화하는 데 유용합니다.
새로운 타사 코드를 추가할 수 있지만 보안을 위해 파일 액세스는 구성에서 허용 목록에 추가되어야 합니다.

라이선스 및 커뮤니티

MIT 라이선스 – 스위트를 자유롭게 사용, 수정 및 재배포할 수 있습니다.
모든 번들 타사 파일은 자체 허용적 라이선스를 가지며 docs/THIRD_PARTY.md에 포함되어 있습니다.
프로젝트는 GitHub 이슈 및 풀 리퀘스트를 통한 기여를 환영하며, 기여 가이드가 제공됩니다.
후원자를 위한 소액 기부 링크(PayPal)가 포함되어 있습니다.

빠른 시작 체크리스트

ComfyUI 0.14+를 설치합니다.
매니저 또는 수동 클론을 통해 스위트를 추가합니다.
ComfyUI를 실행합니다 – 스위트는 첫 실행 시 바이트코드로 컴파일됩니다.
(선택 사항) <ComfyUI 사용자 디렉터리>/was-node-suite/config.yaml을 편집하여 document_export 또는 network와 같은 추가 그룹을 활성화합니다.
전체 노드 입력/출력 목록은 NODES.md 파일을 열거나 ComfyUI 내부의 노드 팔레트를 탐색합니다.

요약하자면: WAS Node Suite v3는 ComfyUI용 대규모 MIT 라이선스 플러그인으로, 수백 개의 즉시 사용 가능한 이미지 처리 및 워크플로 제어 노드를 제공하며, 보안 우선 설계와 필요에 따라 켤 수 있는 선택적 기능을 갖추고 있습니다. ComfyUI에서 생성형 AI 이미지 파이프라인을 구축하는 모든 사람(일반 크리에이터부터 상용 서비스를 개발하는 개발자까지)을 대상으로 합니다.