Hata Sözlüğü

torch.cuda.OutOfMemoryError: CUDA out of memory. Tried to allocate …

Ekran kartının belleği yetmedi. En sık görülen hata budur ve neredeyse her zaman istenen işin karta sığmamasından kaynaklanır.

• Çözünürlüğü düşür. Bellek ihtiyacı piksel sayısıyla birlikte artar; kenarları yarıya indirmek ihtiyacı dörtte bire düşürür.
• batch_size değerini 1 yap. Birden fazla görsel istiyorsan batch count kullan, o sırayla çalışır ve ek bellek istemez.
• ComfyUI'ı --lowvram veya --novram bayrağıyla başlat.
• Modelin fp8 veya GGUF halini indir. Aynı model, çok daha az bellek.
• VAE çözme aşamasında patlıyorsa Tiled VAE Decode düğümüne geç.
• Hata birkaç başarılı üretimden sonra geldiyse bellek parçalanmıştır — ComfyUI'ı yeniden başlat.
• Tarayıcıdaki ağır sekmeleri ve oyun istemcilerini kapat, onlar da VRAM tutar.

Expected all tensors to be on the same device, but found at least two devices, cuda:0 and cpu!

İşlemin bir kısmı ekran kartında, bir kısmı işlemcide çalışıyor. Model parçaları farklı yerlere yüklenmiş.

• ComfyUI'ı tamamen kapatıp yeniden başlat. Çoğu durumda bu yeterli.
• Bellek bayraklarını karıştırma — --lowvram ve --gpu-only aynı anda kullanılmaz.
• Son kurduğun custom node'u devre dışı bırakıp dene. Eski node'lar yeni ComfyUI sürümlerinde bu hatayı verebiliyor.

Allocation on device 0 would exceed allowed memory / CUDA error: out of memory

Yukarıdakinin başka bir ifadesi. Bellek ayırma isteği reddedildi.

• Üstteki CUDA out of memory maddesindeki adımların aynısı geçerli.
• Sürücün çok eskiyse de görülebilir; ekran kartı sürücüsünü güncelle.

mat1 and mat2 shapes cannot be multiplied (… x … and … x …)

Farklı mimarilerden parçaları birbirine bağladın. En yaygın sebebi SD 1.5 için eğitilmiş bir LoRA'yı SDXL modeline takmak, ya da tersi.

• LoRA, ControlNet ve IPAdapter dosyalarının model ailesini kontrol et. SD 1.5 parçası yalnızca SD 1.5 modeliyle çalışır.
• Pony ve Illustrious SDXL tabanlıdır, SDXL parçalarını kabul eder.
• Flux için Flux'a özel LoRA ve ControlNet gerekir, SDXL olanlar çalışmaz.

The size of tensor a (64) must match the size of tensor b (96) at non-singleton dimension 3

İki görselin veya latentin ölçüleri tutmuyor. Genelde ControlNet görseli ya da maske, üretim boyutundan farklı.

• ControlNet'e verdiğin görseli üretim boyutuna Image Resize ile eşitle.
• Inpainting yapıyorsan maskenin kaynak görselle aynı ölçüde olduğundan emin ol.
• Latent boyutunu değiştirdiysen akıştaki diğer görsel girişlerini de güncelle.

Given groups=1, weight of size […], expected input […] to have N channels

Bir düğüme beklediğinden başka türde bir model bağlanmış. Örneğin SD 1.5 VAE'si SDXL akışına.

• VAE'nin model ailesiyle eşleştiğini kontrol et.
• Inpainting modeli yerine normal model (ya da tersi) bağlamadığından emin ol — kanal sayıları farklıdır.

ERROR: Could not detect model type / Unable to determine model type

ComfyUI dosyanın hangi tür model olduğunu anlayamadı. Genelde dosya yanlış klasörde ya da indirme yarım kalmış.

• Tek başına difüzyon modelini models/unet klasörüne koy, checkpoints içine değil. Checkpoint klasörü üç parçayı birden taşıyan dosyalar içindir.
• Dosya boyutunu sitedeki boyutla karşılaştır. Eksikse indirme yarıda kalmıştır, yeniden indir.

When loading the graph, the following node types were not found

Workflow'da kullanılan düğümler sende kurulu değil. Tuvalde kırmızı kutular olarak görünürler.

• ComfyUI Manager → Install Missing Custom Nodes. Eksikleri bulup kurar.
• Kurulum bittikten sonra ComfyUI'ı yeniden başlat, sayfayı yenilemek yetmez.
• Manager bulamıyorsa düğümün adını arat, geliştiricinin deposunu custom_nodes klasörüne klonla.

Prompt outputs failed validation: Value not in list: ckpt_name: '…' not in []

Seçili model dosyası bulunamıyor. Köşeli parantez boşsa o klasörde hiç dosya yok demektir.

• Dosyanın doğru klasörde olduğundan emin ol: checkpoint'ler models/checkpoints, LoRA'lar models/loras, VAE'ler models/vae.
• Tarayıcıda R tuşuna bas ya da ComfyUI'ı yeniden başlat; model listesi açılışta okunur.
• Başkasının workflow'unu açtıysan o dosya sende olmayabilir — kendi modelini seç.

Required input is missing: … / Prompt has no outputs

Bir düğümün zorunlu girişi bağlanmamış, ya da akışın sonunda kaydeden bir düğüm yok.

• Hata hangi düğümü işaret ediyorsa onun sol tarafındaki boş uçları ara.
• Akışın sonunda Preview Image veya Save Image olduğundan emin ol. Çıktısı olmayan akış çalışmaz.

ModuleNotFoundError: No module named '…'

Kurduğun bir custom node'un ihtiyaç duyduğu Python paketi eksik.

• Manager → ilgili düğüm → Try fix.
• Olmazsa o düğümün klasöründeki requirements.txt dosyasını elle kur. Portable sürümde ComfyUI'ın kendi Python'unu kullanman gerekir, sistemdekini değil.

'NoneType' object has no attribute '…'

Bir düğüm beklediği veriyi alamadı. Öncesindeki düğüm boş döndürmüş ya da bağlantı kopuk.

• Hatanın işaret ettiği düğümden geriye doğru bağlantıları takip et.
• Bypass veya mute ettiğin bir düğüm akışı kesiyor olabilir.

Error while deserializing header: HeaderTooLarge / unexpected EOF

Model dosyası bozuk. Neredeyse her zaman indirme yarıda kalmıştır.

• Dosyayı sil ve yeniden indir. Tarayıcı yerine indirme yöneticisi kullanmak büyük dosyalarda daha güvenli.

AssertionError: Torch not compiled with CUDA enabled

PyTorch'un işlemci sürümü kurulu. Ekran kartın kullanılamıyor.

• En kolay yol: resmî portable sürümü indir, doğru PyTorch'la birlikte gelir.
• Elle kurduysan CUDA'lı PyTorch sürümünü kur, kart modeline uygun olanı seç.

OSError: [Errno 98] Address already in use / port 8188

ComfyUI zaten çalışıyor. İkinci kopya aynı adresi kullanamıyor.

• Açık olan ComfyUI penceresini bul ve kapat.
• Göremiyorsan görev yöneticisinden python işlemini sonlandır.
• Bilerek ikinci kopya çalıştırıyorsan --port 8189 ekle.

Üretim çok yavaş — bir görsel dakikalar sürüyor

Hata mesajı yok ama işlem ekran kartı yerine işlemcide çalışıyor olabilir.

• Başlangıç günlüğüne bak. Device: cuda yazmıyorsa kart kullanılmıyor demektir.
• Başlatma betiğinde --cpu bayrağı var mı kontrol et.
• Kart görünüyor ama yavaşsa modelin her üretimde diske inip çıkmadığına bak — yetersiz VRAM'de ComfyUI model takası yapar ve bu çok yavaşlatır.

Çıktı tamamen siyah geliyor

Hata vermiyor ama görsel boş. Genelde VAE aşamasında sayısal taşma oluyor — özellikle bazı SDXL VAE'lerinde fp16 ile.

• ComfyUI'ı --no-half-vae bayrağıyla başlat.
• Ya da fp16 için düzeltilmiş SDXL VAE dosyasını indirip kullan.
• Flux'ta görülüyorsa model dosyasının bf16 halini dene; fp16 Flux'ta taşmaya daha yatkın.

Görsel solgun, bulanık veya renkleri kaymış

Yanlış VAE kullanılıyor ya da hiç VAE yüklenmemiş.

• VAE'nin model ailesiyle eşleştiğinden emin ol.
• Checkpoint'in içindeki VAE'yi kullanmak istiyorsan ayrı VAE yükleyen düğümü bypass et.

Aynı sahnede iki kafa, kopyalanmış gövdeler

Hata değil, boyut sorunu. Model eğitildiği alanın çok üstünde bir çözünürlük istendiğinde öğrendiği kalıbı tekrarlıyor.

• Modelin kendi ölçüsünde üret, sonra büyüt. Çözünürlük seçici doğru ölçüyü verir.
• Büyütmeyi düşük denoise ile ikinci bir üretim olarak yap.

Negatif prompt hiçbir şey yapmıyor

Hata değil. Turbo, Lightning, Hyper ve Flux schnell gibi damıtılmış modellerde CFG 1 kullanılır, CFG 1'de negatif prompt devre dışı kalır.

• Negatif prompt kullanmak istiyorsan damıtılmamış bir model seç ve CFG'yi 1'in üstüne çıkar.
• Flux dev'de klasik CFG yerine guidance değeri vardır, negatif prompt yine etkisizdir.

CUDA error: device-side assert triggered

Modele geçersiz bir değer gitti. Genelde uyumsuz bir embedding ya da bozuk bir token kaynaklı.

• Prompt'tan embedding çağrılarını tek tek çıkararak dene.
• ComfyUI'ı yeniden başlat; bu hatadan sonra oturum genelde kullanılamaz hale gelir.