ComfyUI Einrichtung — Lokale KI-Generierung
Maschine
- Windows 10 Pro, RTX 3090 24 GB (Ampere), 28 GB RAM (→40 GB), Xeon E5-2696 v4
- Laufwerke: C: (Betriebssystem, 35 GB frei), D: SSD 207 GB, E: HDD 9,3 TB
- ComfyUI 0.44.0 portabel (CUDA 13, Python 3.13) unter
D:\AI\ComfyUI
- Server:
http://127.0.0.1:8188
Ordnerstruktur
D:\AI\ComfyUI — App + python_embeded
D:\AI\models\ — alle Modelle (via extra_model_paths.yaml)
D:\AI\workflows\ — 2d/, 3d/, video/ Workflow-JSONs
D:\AI\outputs\staging\<projekt>\ — projektbezogene Ausgaben
D:\AI\cache\ — HF/Torch-Downloads (HF_HOME, TORCH_HOME)
D:\AI\README.txt, SETUP_DOCUMENTATION.md, HANDOFF.md, PROJECTS.md
Modell-Ordner
| Typ | Ordner | Lader |
|---|
| SDXL-Checkpoint | D:\AI\models\checkpoints\ | CheckpointLoaderSimple |
| Diffusionsmodell (UNET) | D:\AI\models\diffusion_models\ | UNETLoader |
| Text-Encoder | D:\AI\models\text_encoders\ | CLIPLoader |
| VAE | D:\AI\models\vae\ | VAELoader |
| ControlNet/Patch | D:\AI\models\model_patches\ | ModelPatchLoader |
| LoRA | D:\AI\models\loras\ | LoraLoader |
| CLIP-Vision | D:\AI\models\clip_vision\ | CLIPVisionLoader |
| Upscaling | D:\AI\models\upscale_models\ | UpscaleModelLoader |
| Hintergrundentfernung | D:\AI\models\background_removal\ | LoadBackgroundRemovalModel |
| 3D | D:\AI\models\diffusion_models\ + vae\ | Native 3D-Knoten |
Kritische Regeln
- Sowohl
widgets_values als auch widgets_values_named müssen aktualisiert werden, wenn Modellnamen in einem Workflow geändert werden. ComfyUI 0.44.0 verwendet widgets_values_named für die tatsächlichen Werte.
- ComfyUI neu starten nach dem Hinzufügen von Modellen (Modellliste wird beim Start gecached).
- Browser-Cache: Wenn „Fehlendes Modell“ erscheint, Seite neu laden (F5) und Workflow erneut öffnen.
- int8/FP8-Builds werden für 28 GB RAM benötigt. BF16 benötigt 40 GB.
- H3 erfordert:
--disable-pinned-memory --fp16-intermediates Flags.
- Modelltypen nicht mischen. Z-Image verwendet UNET/CLIP/VAE (getrennt). SDXL-Checkpoints verwenden CheckpointLoaderSimple.
- extra_model_paths.yaml verwendet Vorwärtsschrägstriche:
D:/AI/models/.
- HF/Torch-Cache muss auf D: liegen (in der Start-BAT-Datei festgelegt).
- MarkdownNote-Knoten können Modellnamen im Text referenzieren; diese bereinigen, um falsche „Fehlendes Modell“-Warnungen zu vermeiden.
Ein neues Modell installieren
- Herunterladen nach
D:\AI\downloads\ via curl.
- In den richtigen Ordner unter
D:\AI\models\ verschieben.
- Safetensors-Header überprüfen:
D:\AI\ComfyUI\python_embeded\python.exe -c "import struct,json,sys; sys.stdout.reconfigure(encoding='utf-8'); f=open(r'<Pfad>','rb'); n=struct.unpack('<Q',f.read(8))[0]; h=json.loads(f.read(n)); print('OK', len(h), 'Tensoren')"
- ComfyUI neu starten.
- Überprüfen, ob der Lader das Modell sieht via
http://127.0.0.1:8188/object_info/<LaderKnoten>.
- Workflow aus vorhandener Vorlage erstellen, sowohl
widgets_values als auch widgets_values_named aktualisieren.
- Testen via API (siehe
test_zimage.py als Muster).
- README und Dokumentation aktualisieren.
Startbefehle
:: Normal (Bilder, 3D, Allgemein)
D:\AI\ComfyUI\run_nvidia_gpu.bat
:: --enable-manager
:: Video (MiniMax H3)
D:\AI\ComfyUI\run_nvidia_gpu_video.bat
:: --enable-manager --disable-pinned-memory --fp16-intermediates
Wichtige Modelle und Einstellungen
| Modell | Dateien | Einstellungen |
|---|
| Z-Image Turbo | int8 UNET + FP8 Encoder + ae.safetensors | 8-9 Schritte, CFG 1,0, res_multistep, einfach, 1024-1344px |
| Nova Anime XL v19 | NovaAnimeILV190.safetensors (SDXL) | 28 Schritte, CFG 5, euler_ancestral, normal, CLIP Skip 2 |
| Prefect Pony XL v6 | PrefectPonyXLV6.safetensors (Pony/SDXL) | 28 Schritte, CFG 6, euler_ancestral, normal, CLIP Skip 2 |
| Pixal3D/TRELLIS.2 | int8 UNETs + VAEs + DINOv3 + BiRefNet + MoGe | 1024px, Boolean: aus=Pixal3D, an=TRELLIS.2 |
| MiniMax H3 | int8 bereinigt + NVFP4 Encoder + Video/Audio-VAEs | 5s 864x480, 4-Schritt-Turbo-LoRA; 15s 1344x768 ~23 Min |
Häufige Probleme
| Problem | Lösung |
|---|
hostbuf_file_reader_read failed | --disable-dynamic-vram oder int8/FP8-Builds verwenden |
Fault failed: 2 (H3) | --disable-pinned-memory --fp16-intermediates + niedrigere Auflösung |
| Bildschirm wird schwarz (TDR) | Auflösung/Schritte reduzieren; TDR-Verzögerung in Registry erhöhen |
| Dialog „Fehlendes Modell“ | Beide Widgets-Felder korrigieren; ComfyUI neu starten; Seite neu laden |
| Modell nicht in Dropdown | ComfyUI neu starten (Modellliste wird beim Start gecached) |
| H3 I2V schlägt fehl | FL2VA nicht installiert; sicheres R2V-Workflow verwenden |
Dokumentationsdateien
D:\AI\README.txt — Kurzreferenz für Benutzer
D:\AI\SETUP_DOCUMENTATION.md — vollständige 13-teilige Referenz
D:\AI\HANDOFF.md — Kurzreferenz für Agenten (Installationsverfahren)
D:\AI\PROJECTS.md — Projektverwaltung
D:\AI\projects\<Slug>\README.md — projektspezifische Dokumentation
Nicht installiert (auf Anfrage verfügbar)
SDXL-Basis, FLUX, Pixel-Art-LoRAs, SDXL ControlNet, H3 FL2VA, Upscaling-Modelle (ESRGAN/SeedVR2), Textur-LoRAs, Kohya-Trainingswerkzeuge, Krita AI Diffusion, Aseprite/Pixelorama.