ComfyUI kurulumu ve ilk görseli oluşturma

Comfy Desktop, ComfyUI’nin resmî masaüstü uygulamasıdır. ComfyUI ile gerekli çalışma ortamını birlikte kurduğu için Python, CUDA veya pip’i ayrıca yapılandırmanız gerekmez. Aynı bilgisayarda birbirini etkilemeyen birden fazla kurulum da tutabilirsiniz; bu, farklı sürümleri veya yapılandırmaları ayrı ayrı denemek için uygundur.

Kurulumdan önce hazırlık

Öncelikle bilgisayarınızın aşağıdaki koşulları karşıladığından emin olun:

• Windows 10 veya daha yeni bir sürüm; x64 ya da ARM64 desteği gerekir. NVIDIA veya AMD bağımsız ekran kartı önerilir ancak bağımsız ekran kartı olmadan da kurulum yapılabilir.
• macOS 13 (Ventura) veya daha yeni bir sürüm ve Apple çipli (M1 veya daha yeni) bir Mac.
• Linux. Kurulum paketleri .deb ve AppImage biçimlerinde sunulur. Ubuntu 22.04 veya daha yeni bir sürüm ile x64 mimarisi önerilir.

Her ComfyUI kurulumu yaklaşık 4,85 GB disk alanı gerektirir. En az 8 GB bellek ayırın; 16 GB daha uygun bir kullanım sunar. Daha sonra indireceğiniz görsel modelleri de ek disk alanı kullanır.

macOS

dmg dosyasını açın

• Uygulamalar'a sürükleyin
• İlk seferde Gizlilik ve Güvenlik'e gidin
• Yine de Aç'a tıklayın

Windows

exe dosyasını çalıştırın

• Windows 10 veya daha yeni
• x64 veya ARM64
• Karşılama sayfasından kurulum oluşturun

Linux

deb veya AppImage

• Ubuntu 22.04+ önerilir
• x64
• Başlatma başarısız olursa korumalı alan açıklamasına bakın

Kurulum ve ilk başlatma

Kurulum paketini almak için Comfy Desktop indirme sayfasına gidin. Sayfa, kullandığınız sistemi otomatik olarak algılar.

macOS

1. İndirdiğiniz .dmg dosyasını açın.
2. Comfy Desktop’ı Uygulamalar klasörüne sürükleyin.
3. Comfy Desktop’ı Launchpad veya Spotlight araması üzerinden açın.

İlk başlatmada macOS bir güvenlik uyarısı gösterebilir. Bu durumda Sistem Ayarları içindeki Privacy & Security (Gizlilik ve Güvenlik) bölümünü açıp Open Anyway (Yine de Aç) düğmesine tıklayın. Bu düğme, sistem tarafından az önce engellenen uygulamanın başlatılmasına izin verir.

Windows

İndirdiğiniz .exe dosyasını (NSIS kurulum paketi) çalıştırın, ekrandaki talimatları izleyerek kurulumu tamamlayın ve ardından Başlat menüsünden veya masaüstü kısayolundan Comfy Desktop’ı açın.

İlk başlatmada karşılama ekranı görüntülenir. İlk ComfyUI kurulumunuzu burada oluşturabilirsiniz.

Linux

Linux için genel indirme bağlantısı kullanılır. Debian veya Ubuntu kullanıcıları, kurulum paketinin bulunduğu indirme dizinine gidip şu komutu çalıştırmalıdır:

sudo apt install ./*.deb

AppImage kullanırken şunları çalıştırın:

chmod +x ./*.AppImage
./*.AppImage

Uygulama başlatılamazsa Linux dağıtımı Electron sandbox’ını engelliyor olabilir. Ubuntu 24.04 ve daha yeni sürümler, ayrıcalıksız kullanıcı ad alanlarını AppArmor aracılığıyla kısıtlar. Yalnızca sorunun sandbox başlatma hatasından kaynaklandığını doğruladıysanız --no-sandbox ekleyerek yeniden deneyin. Bu parametre, her işlem için Electron sandbox’ını devre dışı bırakır ve diğer durumlarda kullanılması önerilmez.

Comfy Desktop’ı açtığınızda Chooser sayfası mevcut kurulum örneklerini listeler. Yeni ve diğerlerinden bağımsız bir ComfyUI kurulumu oluşturmak için New Instance düğmesine tıklayın, ardından başlatmak istediğiniz kurulumun kartına tıklayın.

Masaüstü sürümü varsayılan olarak kararlı sürümü takip eder. GitHub’daki en yeni commit’lerin tümünü takip etmek istiyorsanız taşınabilir sürümü veya manuel git kurulumunu kullanabilir ya da kurulumun güncelleme kanalını Latest on GitHub olarak değiştirebilirsiniz.

OmniProxy’den bağlantı parametrelerini alma

Burada kullanılabilecek genel bir adres, anahtar veya model kimliği yoktur. Comfy Desktop’ı kurmak ve temel metinden görsel oluşturma akışını tamamlamak için OmniProxy gerekmez.

Başka araçlara ait Base URL değerlerini kaynağı belirsiz düğümlere girmeyin. Genel entegrasyon talimatları açıkça sunulduğunda yapılandırmayı ayrıca yapın.

Araç yapılandırmasını girme

Burada bir OmniProxy yapılandırma formu yoktur. İlk görseli oluşturmadan önce bir iş akışı ve görsel modeli hazırlamanız gerekir.

İş akışı, görsel oluşturma adımlarından oluşan bir düzen olarak düşünülebilir. Düğümler ise bu düzen içinde model yükleme, metin alma veya görsel kaydetme gibi işlemlerden sorumlu modüllerdir. ComfyUI başlatıldığında genellikle varsayılan metinden görsel oluşturma iş akışı otomatik olarak yüklenir.

Başka bir iş akışını açmanız gerekiyorsa menüden Workflows → Open seçeneğini belirleyin. Bu seçenek, iş akışı bilgileri içeren bir görseli veya JSON iş akışı dosyasını yüklemek için kullanılır.

Çoğu kurulum varsayılan olarak temel model içermez. İş akışını yükledikten sonra bilgisayarınızda v1-5-pruned-emaonly-fp16.safetensors yoksa arayüz eksik model uyarısı gösterir. Uyarıyı açarak eksik modeli ve indirme bağlantısını görebilirsiniz.

Geçerli kurulumun kullandığı model dizinini görmek için üst kısımdaki kapsül menüye tıklayıp Storage bölümünü açın. Bu bölüm, modeller gibi dosyaların gerçekte nereye kaydedildiğini gösterir. Üstteki kapsül menü yalnızca masaüstü uygulamasında bulunur. Dizinin yanındaki klasör simgesine tıklayarak ilgili dizini doğrudan sistem dosya yöneticisinde açabilirsiniz.

Modeli iki şekilde indirebilirsiniz:

• Arayüzdeki Download düğmesine tıklayın. Bu düğme eksik modelin indirilmesini başlatır. Masaüstü sürümü modeli geçerli kurulumdaki ComfyUI/models/checkpoints dizinine kaydeder. İndirme ilerlemesini kenar çubuğundaki model panelinden görebilirsiniz. Otomatik indirmeler genellikle Hugging Face üzerinden yapıldığından ağınızın Hugging Face’e erişebilmesi gerekir.
• Uzun süre indirme ilerlemesi görünmezse eksik modelin ayrıntılarındaki indirme bağlantısını kopyalayın, dosyayı manuel olarak indirin ve aynı checkpoints dizinine kaydedin. Ardından ComfyUI’yi yenileyin veya yeniden başlatın.

Modeli doğru konuma yerleştirdikten sonra arayüzün düğümlerdeki model listesini yeniden okuması için klavyede R tuşuna basın.

Uygulama

Comfy Desktop

• Ortam kurulumunu yönetir
• Karşılama sayfasını kullanın veya yeni örnek oluşturun
• Kartı tıklayarak başlatın

İş akışı

Metinden görüntüye

• Genellikle otomatik yüklenir
• Menüden de açılabilir
• Model eksikse uyarı verir

Model

checkpoints

• Uyarıdaki bağlantıdan indirin
• Masaüstü sürümü otomatik kaydedebilir
• Listeyi R tuşuyla yenileyin

Gerçek bir görevi doğrulama

Model hazır olduğunda ilk görselinizi oluşturmayı denemek için şu adımları izleyin:

1. Load Checkpoint düğümünde v1-5-pruned-emaonly-fp16.safetensors modelini seçin. Bu düğüm, mevcut görsel oluşturma işleminde kullanılacak modeli yükler.
2. Run düğmesine tıklayın veya Ctrl + Enter tuşlarına basın. Run, geçerli görsel oluşturma görevini başlatır.
3. Oluşturulan sonuç Save Image düğümünde gösterilir. Bu düğüm, nihai görseli önizlemek ve kaydetmek için kullanılır. Görsele sağ tıklayarak dosyayı bilgisayarınıza kaydedebilirsiniz.

Load Checkpoint içinde bir model yoksa veya açılır kutuda null görünüyorsa önce model dizinini kontrol edin, ardından ComfyUI’yi yenileyin veya yeniden başlatın.

2026-10-09 itibarıyla resmî dmg üzerinden edinilen Comfy Desktop 1.1.6’nın macOS’te başlatılabildiği doğrulanmıştır. Uygulama içinde ayrıca bir kurulum oluşturulması ve checkpoint modelinin indirilmesi gerektiğinden ilk görsel oluşturma akışı tamamlanmamıştır. Bu nedenle burada başarılı bir görsel oluşturulduğu iddia edilmemekte ve OmniProxy, ComfyUI’ye bağlanmamaktadır.

Model

Açılır listede bir ad var

• null değil
• Kontrol noktasını seçin
• R tuşuyla yenilenmiş

Oluşturma

Çalıştır'a tıklayın

• Veya Ctrl+Enter tuşlarına basın
• Düğümlerin tamamlanmasını bekleyin
• Görüntü, Görüntüyü Kaydet bölümünde

Sınır

Şimdilik ağ geçidine bağlamayın

• Genel bir yapılandırma alanı yok
• Kaynağı belirsiz düğümler kurmayın
• Görüntünün başarıyla oluşturulması yeterli

Yaygın hatalar

• macOS’te açılamıyor: Sistem Ayarları → Gizlilik ve Güvenlik bölümüne gidip Yine de Aç düğmesine tıklayın. Kurulum paketi yalnızca Apple çipli cihazları ve macOS 13 veya daha yeni sürümleri destekler.
• Linux’ta başlatıldıktan hemen sonra kapanıyor: Önce .deb veya AppImage kullandığınızı doğrulayın. Yalnızca sorunun sandbox başlatma hatası olduğu kesinleştiğinde --no-sandbox ekleyin.
• Eksik model uyarısı gösteriliyor: Uyarıdaki bağlantıyı kullanarak checkpoint modelini indirin, geçerli kurulumun models/checkpoints dizinine kaydedin ve ardından yenilemek için R tuşuna basın.
• Model açılır kutusunda null görünüyor: Storage üzerinden model dizinini kontrol edin, dosyanın doğru konuma yerleştirildiğini doğrulayın ve ardından yenileyin veya yeniden başlatın.
• OmniProxy bilgilerini buraya girmek istiyorsunuz: Şu anda genel bir entegrasyon alanı yoktur. Genel entegrasyon yöntemi olduğu açıkça belirtilmeyen düğümleri ayrıca kurmayın.

Resmî başvuru kaynakları

Kuruluma genel bakış için Comfy Desktop sayfasına bakın. Platformlara özel kurulum adımları için macOS, Windows ve Linux sayfalarına bakın. Masaüstü arayüzünün kullanımı için Using Comfy Desktop sayfasına bakın. İlk görseli oluşturma adımları için Getting Started with AI Image Generation sayfasına bakın.

Tüm yer tutucuları kendi OmniProxy yapılandırmanızdaki değerlerle değiştirin. Gerçek bir anahtar asla paylaşmayın.

Kaydedilmiş bir sonuç veya yalnızca HTTP 200, tam Aracı uyumluluğunu kanıtlamaz. OmniProxy'nin çağrı kaydındaki kaynağı ve modeli kontrol edin.

Resmi kaynaklar · ComfyUI ↗