ComfyUI 포터블 버전 유실 의존성 패키지 순차 복구 가이드
실제 복원 테스트를 거친 Windows Standalone 포터블 ComfyUI 환경 복구 기록. SQLAlchemy, torch, 프론트엔드, kornia, PyOpenGL 등 유실 대응.
Windows Standalone 포터블 ComfyUI 환경이 핵심 패키지 유실로 인해 실행되지 않는다면, 즉시 프로그램을 재설치해 시간과 자원을 낭비하지 마십시오.
가장 추천되는 안전한 복원 사이클은 다음과 같습니다.
- ComfyUI를 실행한다.
- 터미널창 로그에 가장 먼저 출력되는 첫 번째 모듈 누락 에러(
ModuleNotFoundError등)를 확인한다. - 오직
python_embeded경로를 거치는 pip 명령을 사용하여 해당 패키지 하나만 설치한다. - 서버를 다시 실행해 본다.
- 에러 로그가 모두 해소되어 서버가 정상 구동될 때까지 위의 과정을 반복한다.
본 가이드의 내용은 2026년 5월 18일 실제 손상된 포터블 환경을 복원한 실험에 기반합니다. 실험은 최초 ModuleNotFoundError: No module named 'sqlalchemy' 오류에서 시작되어, 최종적으로 RTX 4070 Ti SUPER GPU에서 CUDA PyTorch 가속 환경을 온전히 복구해 내는 과정으로 마무리되었습니다.
실행 원칙
패키지는 한 번에 딱 하나씩만 설치하세요. 설치 후 서버를 다시 기동해 변경되는 에러 로그를 관찰합니다. 긴 일괄 설치 코드를 무작정 난사하지 마세요. 꼬인 패키지가 늘어나 가상환경이 더 망가집니다.
복구 대상 적용 기준
특정 커스텀 노드가 아닌, 환경 실행 그 자체에 쓰이는 기반 핵심 라이브러리들이 누락되어 켜지지 않을 때 이 가이드를 적용합니다.
| 현재 증상 | 더 적합한 가이드 |
|---|---|
| 서버 구동(Starting server) 텍스트가 뜨기 전에 멈추며, 재시작 시마다 잇따라 유실 에러가 발생함 | 본 가이드 (순차 복원 루프) |
특정 커스텀 노드 단 하나만 IMPORT FAILED 경고가 뜸 | ComfyUI 플러그인 가져오기 실패 |
| 붉은색 노드가 표시되지만 서버 구동 및 웹브라우저 창 로드는 정상임 | ComfyUI 누락 노드를 통해 해당 노드 등록 여부 점검 |
| Torch 라이브러리는 가져오지만 CUDA 가속이 안 됨 | 임의 패키지 설치 전에 Torch에 CUDA 지원이 컴파일되지 않은 경우 확인 |
| 노드는 등록되었으나 모델 파일 경로를 찾지 못함 | Safetensors 파일 위치 또는 모델 파일을 찾을 수 없음 |
실제 복원 테스트 에러 추이 로그
아래는 손상된 실험 환경 복원 시 기록된 순차 조치 내역과 터미널 로그의 변화 추이입니다.
| 단계 | 터미널 에러 로그 | 조치한 단일 설치 명령 | 조치 후 도출된 신규 에러 |
|---|---|---|---|
| 1 | ModuleNotFoundError: No module named 'sqlalchemy' | pip install "SQLAlchemy>=2.0" | filelock 누락으로 진전 |
| 2 | ModuleNotFoundError: No module named 'filelock' | pip install filelock | alembic 및 yaml 누락으로 진전 |
| 3 | Error importing dependencies: No module named 'alembic' | pip install alembic | 데이터베이스 초기화 진행 확인 |
| 4 | ModuleNotFoundError: No module named 'yaml' | pip install PyYAML | PIL 누락으로 진전 |
| 5 | ModuleNotFoundError: No module named 'PIL' | pip install Pillow | tqdm 누락으로 진전 |
| 6 | ModuleNotFoundError: No module named 'tqdm' | pip install tqdm | 낯선 내부 모듈처럼 보이는 import 오류로 진행 |
| 7 | 낯선 ComfyUI 내부 모듈처럼 보이는 ModuleNotFoundError | 로컬 requirements 또는 공식 ComfyUI 패키지 메타데이터를 먼저 확인 | import 이름만 보고 PyPI 패키지를 추측하지 않기 |
| 8 | ModuleNotFoundError: No module named 'torch' | ComfyUI Torch Missing에 따라 embedded Python에 맞는 CUDA wheel 선택 | CUDA 검증 후 다음 복구로 진행 |
| 9 | ModuleNotFoundError: No module named 'safetensors' | pip install safetensors | packaging 누락으로 진전 |
| 10 | ModuleNotFoundError: No module named 'packaging' | pip install packaging | numpy 누락으로 진전 |
| 11 | ModuleNotFoundError: No module named 'numpy' | pip install "numpy>=1.25.0" | einops 누락으로 진전 |
| 12 | ModuleNotFoundError: No module named 'einops' | pip install einops | psutil 누락으로 진전 |
| 13 | ModuleNotFoundError: No module named 'psutil' | pip install psutil | VRAM 감지 돌입 후 torchvision 누락 |
| 14 | ModuleNotFoundError: No module named 'torchvision' | CUDA 전용 휠 인덱스에서 torchvision 강제 지정 설치 | torchaudio 누락으로 진전 |
| 15 | ModuleNotFoundError: No module named 'torchaudio' | 동 인덱스 주소에서 torchaudio 강제 지정 설치 | scipy 누락으로 진전 |
| 16 | ModuleNotFoundError: No module named 'scipy' | pip install scipy | transformers 누락으로 진전 |
| 17 | ModuleNotFoundError: No module named 'transformers' | pip install transformers | torchsde 누락으로 진전 |
| 18 | ModuleNotFoundError: No module named 'torchsde' | pip install torchsde | av 누락으로 진전 |
| 19 | ModuleNotFoundError: No module named 'av' | pip install av | aiohttp 누락으로 진전 |
| 20 | ModuleNotFoundError: No module named 'aiohttp' | pip install aiohttp | requests 누락으로 진전 |
| 21 | ModuleNotFoundError: No module named 'requests' | pip install requests | pydantic 누락으로 진전 |
| 22 | ModuleNotFoundError: No module named 'pydantic' | pip install pydantic | comfyui-frontend-package 누락 |
| 23 | comfyui-frontend-package is not installed | pip install comfyui-frontend-package | 서버는 작동하나 일부 노드 등록 실패 |
기본 서버 기동 성공 이후, 콘솔에 잔존한 비치명적 누락 경고들의 추가 정리 내역:
| 경고 로그 내용 | 실행한 설치 조치 | 해결 결과 |
|---|---|---|
Canny 노드 등에서 No module named 'kornia' | pip install kornia | 인지된 총 노드 수 657개에서 685개로 증가 |
nodes_upscale_model.py에서 No module named 'spandrel' | pip install spandrel | 인지된 총 노드 수 687개로 증가 |
설정 로드 과정 중 No module named 'pydantic_settings' | pip install pydantic-settings | 부팅 경고 로그 대폭 감소 |
OpenGL dependencies not available | pip install PyOpenGL 후 pip install glfw | GLSL 관련 노드들의 등록 성공 |
nodes_math.py에서 No module named 'simpleeval' | pip install simpleeval | 시작 로그상에서 IMPORT FAILED 소멸 |
comfyui-workflow-templates is not installed | pip install comfyui-workflow-templates | 템플릿 관련 경고 해소 |
0단계: 포터블 설치 경로 지정
아래 항목들이 담겨 있는 포터블 압축 해제 루트 디렉토리 경로에서 PowerShell 창을 실행합니다.
run_nvidia_gpu.batrun_cpu.batpython_embededComfyUI
아래를 쳐서 내장 Python 실행 파일 위치가 올바른지 인지합니다.
.\python_embeded\python.exe -s -c "import sys; print(sys.executable); print(sys.version)"1단계: 복구 과정 로그 수집
에러 추이를 매번 터미널에서 보기 힘들 때는 실행 결과를 파일로 떨어뜨려 진단하는 것이 좋습니다.
$ts = Get-Date -Format 'yyyyMMdd_HHmmss'
New-Item -ItemType Directory -Force .\repair_logs | Out-Null
$out = ".\repair_logs\attempt_${ts}_stdout.log"
$err = ".\repair_logs\attempt_${ts}_stderr.log"
Start-Process -FilePath ".\python_embeded\python.exe" `
-ArgumentList @("-s", "ComfyUI\main.py", "--windows-standalone-build") `
-WorkingDirectory (Get-Location) `
-RedirectStandardOutput $out `
-RedirectStandardError $err `
-PassThru그 후 아래 명령어로 에러 로그 내용 마지막 부분을 관측합니다.
Get-Content $err -Tail 200로그 마지막 부분에 출력된 최초 유실 모듈만 지정 설치하고 다시 서버를 켭니다.
2단계: 서버 구동 포트 충돌 방지
실험 시 브라우저에 http://127.0.0.1:8188/가 정상 호출되어 성공한 줄 알았으나, 이는 백그라운드에 켜져 있던 다른 ComfyUI 서버가 응답한 것이었습니다.
포트 점유 상태를 파악하세요.
Get-NetTCPConnection -LocalPort 8188 -ErrorAction SilentlyContinue |
Select-Object LocalAddress,LocalPort,State,OwningProcess포트가 선점되어 있다면 겹치지 않는 임의의 타 포트를 지정해 실행해 검증합니다.
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --port 81913단계: CUDA PyTorch 구성
오류 로그에 No module named 'torch'가 뜰 때 bare pip install torch를 치면 CPU-only 버전이 깔릴 수 있습니다. PyTorch 공식 설치 선택기에서 환경에 맞는 CUDA wheel을 고른 뒤 embedded Python으로 실행하세요.
.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXXcuXXX는 지원되는 CUDA wheel 태그로 바꿉니다. 제3자 미러를 주 설치 명령에 섞지 마세요. 그 후 아래 명령어로 CUDA 사용 가능 여부와 GPU 모델명을 확인하십시오.
.\python_embeded\python.exe -s -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available())"4단계: 프론트엔드 버전 통일
comfyui-frontend-package is not installed가 뜬다면, 설치 전 본인의 ComfyUI\requirements.txt 파일을 열어 명시된 특정 프론트엔드 요구 규격 버전을 찾아 일치시켜 설치해 줍니다.
관련 가이드
실제 ComfyUI 환경에서 생긴 문제라면 먼저 무료로 Wonderful Launcher 로 현재 머신을 확인하세요. 런처 안의 복구 흐름, 작업 로그, 실행 환경 점검을 한곳에서 볼 수 있습니다. 크레딧은 이미지 생성과 사용량 기반 도구용입니다.
Wonderful Launcher 다운로드크레딧 요금제 보기Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.