ComfyUI "clean library entry point is missing" 해결
ComfyUI clean library entry point is missing 오류를 워크플로 호환성, 프론트엔드 package 불일치, 손상된 workflow JSON, missing nodes 순서로 점검합니다.
"clean library entry point is missing" comfyui 또는 "a clean library entry point is missing" comfyui 를 검색했다면, 먼저 임의의 Python package를 설치하지 마세요.
이 메시지는 보통 workflow 또는 frontend 호환성 문제를 뜻합니다. workflow가 더 새로운 ComfyUI에서 저장되었거나, frontend package가 오래되었거나, workflow JSON이 호환되지 않거나, 필요한 custom node가 빠져 있을 수 있습니다.
빠른 판단
먼저 ComfyUI와 frontend package를 함께 업데이트한 뒤 http://127.0.0.1:8188 에서 workflow를 다시 여세요. 빨간 node가 남으면 missing node 문제로 보세요. pip install clean-library-entry-point 는 실제 해결책이 아닙니다.
빠른 진단
| 보이는 증상 | 의미 | 먼저 할 일 |
|---|---|---|
clean library entry point is missing | 현재 frontend 또는 workflow system이 entry point를 해석하지 못함 | ComfyUI와 frontend package를 함께 업데이트 |
| 오래된 frontend 경고도 있음 | frontend package 불일치 | comfyui-frontend-package guide |
| 빨간 node가 표시됨 | custom node도 빠져 있음 | ComfyUI Missing Nodes |
node id has no class_type | workflow JSON이 손상되었거나 호환되지 않음 | 원본에서 다시 export |
Failed to Save Workflow Draft | 브라우저 workflow 저장 상태 문제 | Failed to Save Workflow Draft |
일반 missing package 오류가 아닌 이유
clean library entry point 는 package 이름이 아닙니다. ComfyUI 또는 frontend가 workflow/library 상태의 일부를 현재 설치에서 매핑하지 못했다는 단서입니다.
안전한 순서는 다음과 같습니다.
- ComfyUI 코드와 frontend package가 맞는지 확인합니다.
- proxy나 원격 주소가 아니라 로컬 URL에서 workflow를 엽니다.
- workflow가 더 새로운 ComfyUI에서 만들어졌는지 확인합니다.
- 그 다음 missing custom nodes 또는 import failure를 처리합니다.
터미널에 ModuleNotFoundError: No module named ... 가 보이면 No module named guide 로 이동하세요.
복구 순서
http://127.0.0.1:8188로 여세요.- frontend package 경고가 있으면 comfyui-frontend-package guide 를 먼저 사용하세요.
- workflow JSON을 다시 저장하거나 원본 작성자에게 다시 받으세요.
- 빨간 node가 남으면 ComfyUI Missing Nodes 로 진행하세요.
- Manager가 registry를 가져오지 못하면 ComfyRegistry list guide 를 사용하세요.
하지 말아야 할 것
clean library entry point라는 package를 찾아 설치하지 마세요.- 그래프가 보이면 재설치 전에 workflow JSON을 저장하세요.
- frontend 호환성 문제인데 모든 custom node의
requirements.txt를 한꺼번에 실행하지 마세요.
관련 가이드
실제 ComfyUI 환경에서 생긴 문제라면 먼저 무료로 Wonderful Launcher 로 현재 머신을 확인하세요. 작업을 막는 수리에는 Agent Access, credits 는 이미지 생성과 사용량 기반 도구용입니다.
Wonderful Launcher 다운로드Agent Access 보기Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.
모델 경로 미감지
Fix ComfyUI model path not detected, extra_model_paths.yaml not loading models, path format errors, and missing model dropdowns step by step.
ComfyUI ControlNetApplyAdvanced class_type 해결
ComfyUI ControlNetApplyAdvanced class_type, node id has no class_type, Apply ControlNet Advanced missing 오류를 workflow JSON, ComfyUI 버전, ControlNet model, preprocessor로 나눠 해결합니다.