ComfyUI Portable: Fehlende Abhängigkeiten nacheinander beheben
Ein praxiserprobtes Windows Portable ComfyUI-Reparaturprotokoll für SQLAlchemy, torch, Frontend-Pakete, kornia, PyOpenGL und andere Startfehler.
Wenn Ihre Windows Portable ComfyUI-Umgebung aufgrund fehlender Kernpakete nicht startet, installieren Sie die Software nicht sofort neu.
Der empfohlene Reparaturzyklus lautet:
- ComfyUI starten.
- Lesen Sie den ersten neuen Importfehler (z. B.
ModuleNotFoundError) im Protokoll. - Installieren Sie dieses Paket ausschließlich in
python_embeded. - Starten Sie ComfyUI erneut.
- Wiederholen Sie diese Schritte, bis der Server normal startet.
Dieser Leitfaden basiert auf der Behebung einer realen beschädigten Umgebung am 18. Mai 2026. Die Reparatur begann mit ModuleNotFoundError: No module named 'sqlalchemy' und führte schließlich zur erfolgreichen Wiederherstellung auf einer RTX 4070 Ti SUPER mit CUDA PyTorch.
Praxisregel
Installieren Sie immer nur ein Paket auf einmal. Starten Sie danach neu und lesen Sie das Protokoll. Vermeiden Sie lange Installationsbefehle mit vielen Paketen; diese führen häufig zu weiteren Konflikten in der Umgebung.
Wann Sie diesen Leitfaden nutzen sollten
Nutzen Sie diesen Leitfaden, wenn die grundlegenden Startabhängigkeiten der Umgebung selbst fehlen. Wenn nur eine einzelne Custom Node einen Importfehler aufweist, nutzen Sie stattdessen den Plugin-Import-Leitfaden.
| Symptom | Geeigneter Leitfaden |
|---|---|
| Server startet nicht (stoppt vor "Starting server") und bei jedem Neustart fehlt ein anderes Modul | Dieser Leitfaden (Sequenzielle Reparatur) |
Nur eine bestimmte Custom Node meldet IMPORT FAILED | ComfyUI-Plugin-Importfehler beheben |
| Rote Nodes werden angezeigt, aber ComfyUI startet normal | ComfyUI Fehlende Nodes zur Überprüfung der Node-Registrierung |
| Torch wird importiert, aber CUDA ist nicht verfügbar | Torch ohne CUDA-Support beheben vor weiteren Installationen |
| Nodes sind registriert, aber Modelldateien fehlen | Modelle richtig platzieren oder Modell nicht gefunden |
Reparaturprotokoll (Echtes Praxisbeispiel)
Folgende Tabelle zeigt den Ablauf der Fehlerbehebung im Testlabor:
| Versuch | Fehlermeldung im Protokoll | Durchgeführte Installation | Nächster Fehler nach Neustart |
|---|---|---|---|
| 1 | ModuleNotFoundError: No module named 'sqlalchemy' | pip install "SQLAlchemy>=2.0" | Fehler bei filelock |
| 2 | ModuleNotFoundError: No module named 'filelock' | pip install filelock | Fehler bei alembic und yaml |
| 3 | Error importing dependencies: No module named 'alembic' | pip install alembic | Datenbankinitialisierung startet |
| 4 | ModuleNotFoundError: No module named 'yaml' | pip install PyYAML | Fehler bei PIL |
| 5 | ModuleNotFoundError: No module named 'PIL' | pip install Pillow | Fehler bei tqdm |
| 6 | ModuleNotFoundError: No module named 'tqdm' | pip install tqdm | ein unbekanntes, intern wirkendes Importproblem erscheint |
| 7 | ModuleNotFoundError für ein unbekanntes ComfyUI-intern wirkendes Modul | lokale requirements oder offizielle ComfyUI-Paketmetadaten prüfen, bevor du etwas installierst | kein PyPI-Paket aus einem Importnamen raten |
| 8 | ModuleNotFoundError: No module named 'torch' | mit ComfyUI Torch Missing ein passendes CUDA-Wheel für embedded Python wählen | CUDA vor dem nächsten Schritt verifizieren |
| 9 | ModuleNotFoundError: No module named 'safetensors' | pip install safetensors | Fehler bei packaging |
| 10 | ModuleNotFoundError: No module named 'packaging' | pip install packaging | Fehler bei numpy |
| 11 | ModuleNotFoundError: No module named 'numpy' | pip install "numpy>=1.25.0" | Fehler bei einops |
| 12 | ModuleNotFoundError: No module named 'einops' | pip install einops | Fehler bei psutil |
| 13 | ModuleNotFoundError: No module named 'psutil' | pip install psutil | VRAM-Erkennung startet, danach Fehler bei torchvision |
| 14 | ModuleNotFoundError: No module named 'torchvision' | torchvision aus CUDA-Index installieren | Fehler bei torchaudio |
| 15 | ModuleNotFoundError: No module named 'torchaudio' | torchaudio aus CUDA-Index installieren | Fehler bei scipy |
| 16 | ModuleNotFoundError: No module named 'scipy' | pip install scipy | Fehler bei transformers |
| 17 | ModuleNotFoundError: No module named 'transformers' | pip install transformers | Fehler bei torchsde |
| 18 | ModuleNotFoundError: No module named 'torchsde' | pip install torchsde | Fehler bei av |
| 19 | ModuleNotFoundError: No module named 'av' | pip install av | Fehler bei aiohttp |
| 20 | ModuleNotFoundError: No module named 'aiohttp' | pip install aiohttp | Fehler bei requests |
| 21 | ModuleNotFoundError: No module named 'requests' | pip install requests | Fehler bei pydantic |
| 22 | ModuleNotFoundError: No module named 'pydantic' | pip install pydantic | Fehler bei comfyui-frontend-package |
| 23 | comfyui-frontend-package is not installed | pip install comfyui-frontend-package | Server startet, aber einige interne Nodes fehlen |
Bereinigungsschritte nach dem erfolgreichen Start des Servers:
| Warnung / Fehlermeldung | Durchgeführte Installation | Ergebnis |
|---|---|---|
No module named 'kornia' in Canny- oder Morphologie-Nodes | pip install kornia | Anzahl der Nodes steigt von 657 auf 685 |
No module named 'spandrel' in nodes_upscale_model.py | pip install spandrel | Anzahl der Nodes steigt auf 687 |
No module named 'pydantic_settings' beim Laden der Konfiguration | pip install pydantic-settings | Reduzierung der Startwarnungen |
OpenGL dependencies not available | pip install PyOpenGL und danach pip install glfw | GLSL-Nodes erfolgreich importiert |
No module named 'simpleeval' in nodes_math.py | pip install simpleeval | Keine IMPORT FAILED-Zeilen mehr im Protokoll |
Schritt 0: Vorbereitung im Portable-Verzeichnis
Öffnen Sie eine PowerShell im Verzeichnis Ihrer Portable-Installation, das folgende Dateien enthält:
run_nvidia_gpu.bat
run_cpu.bat
python_embeded
ComfyUIÜberprüfen Sie den Python-Pfad der Umgebung:
.\python_embeded\python.exe -s -c "import sys; print(sys.executable); print(sys.version)"Stellen Sie sicher, dass dies die Python-Version ist, die ComfyUI startet.
Schritt 1: Startprotokolle aufzeichnen
Zeichnen Sie bei jedem Reparaturversuch die Startprotokolle auf:
$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 `
-PassThruLesen Sie das Ende des Fehlerprotokolls aus:
Get-Content $err -Tail 200Installieren Sie nur das eine Paket, das für den ersten fatalen Fehler verantwortlich ist, und wiederholen Sie den Test.
Schritt 2: Port-Kollisionen vermeiden
Stellen Sie sicher, dass Port 8188 nicht bereits von einem anderen Prozess belegt ist:
Get-NetTCPConnection -LocalPort 8188 -ErrorAction SilentlyContinue |
Select-Object LocalAddress,LocalPort,State,OwningProcessWeichen Sie bei Konflikten auf einen anderen Port aus:
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --port 8191Schritt 3: PyTorch mit CUDA-Unterstützung installieren
Wenn No module named 'torch' gemeldet wird, kann ein nacktes pip install torch einen CPU-only-Build installieren. Wähle im offiziellen PyTorch-Installer das passende CUDA-Wheel und führe es über embedded Python aus:
.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXXErsetze cuXXX durch den unterstützten CUDA-Wheel-Tag. Mische keinen Drittanbieter-Spiegel in den Hauptbefehl.
Relevante Leitfäden
Wenn dieses Problem deine echte ComfyUI-Umgebung betrifft, starte kostenlos mit Wonderful Launcher. Reparaturfluss, Aufgabenlogs und Laufzeitprüfungen bleiben im Launcher an einem Ort; Credits sind für Bildgenerierung und messbare Tools.
Wonderful Launcher herunterladenCredit-Pakete ansehenDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.
ComfyUI Startup Failed? Schneller diagnostizieren und sauberer reparieren
Behebe ComfyUI-Startfehler durch kaputte Plugins, Dependency-Drift, fehlende Pakete und fragile Umgebungen, ohne sofort neu zu installieren.
Häufige ComfyUI-Probleme und schnelle Lösungen
Schnelle Fixes für häufige ComfyUI-Probleme – CUDA-Fehler, rote Nodes, fehlende Modelle, Prompt has no outputs, langsame Generierung und Reconnecting.