# ComfyUI Tam Paket Kullanım Kılavuzu

**Hedef Sistem:** Windows 10 + RTX 4090 + 64 GB RAM
**Kurulum Konumu:** `D:\__sistem__\ProgramFiles\ComfyUi`
**Kullanım Amacı:** Ticari içerik üretimi (görsel + video + NSFW + LoRA eğitimi)

---

## İçindekiler

1. Hızlı Başlangıç
2. Ön Gereksinimler
3. Kurulum Adımları
4. Dahil Edilen Modeller ve Lisansları
5. Workflow Dosyaları
6. Klasör Yapısı
7. Günlük Kullanım
8. LoRA Eğitimi
9. Ek Model İndirme
10. Sorun Giderme
11. Yasal ve Lisans Notları

---

## 1. Hızlı Başlangıç

1. Tüm `ComfyUI_Paket` klasörünü bilgisayarınıza indirin
2. `0_BASLA_BURADAN.bat` dosyasına **sağ tıklayıp "Yönetici olarak çalıştır"** deyin
3. Menüden **[7] Ön gereksinim kontrolü** ile eksikleri görün
4. Eksikleri kurun (aşağıda liste)
5. Menüden **[1] Tam otomatik kurulum** seçin
6. 2-4 saat kurulum tamamlandıktan sonra **[5] ComfyUI'yi başlat** ile çalıştırın
7. Tarayıcıdan `http://127.0.0.1:8188` adresine gidin

---

## 2. Ön Gereksinimler

Kurulum scriptinden **önce** bunları kurmalısınız:

| Gereksinim | İndirme Bağlantısı | Not |
|------------|-------------------|-----|
| Git for Windows | https://git-scm.com/download/win | Varsayılan ayarlarla kurun |
| Python 3.10 veya 3.11 | https://www.python.org/downloads/release/python-31011/ | "Add Python to PATH" kutusunu **mutlaka** işaretleyin. 3.12 henüz tam uyumlu değil |
| NVIDIA Driver | https://www.nvidia.com/Download/index.aspx | 550+ sürüm önerilir |
| aria2c (opsiyonel) | https://github.com/aria2/aria2/releases | Çoklu parça indirme — 5-10x daha hızlı model indirmesi |

**Kontrol:** CMD açıp şu komutları çalıştırın, hepsi çalışmalı:
```
git --version
python --version
nvidia-smi
```

---

## 3. Kurulum Adımları

### Seçenek A — Tek Tıkla Tam Kurulum (Önerilen)

`0_BASLA_BURADAN.bat` → **[1] Tam otomatik kurulum**

Bu sırayla çalışır:
- `1_ANA_KURULUM.bat` — ComfyUI + 15+ custom node (~5-10 GB)
- `2_MODEL_INDIR.bat` — Tüm modeller (~200 GB)
- `4_LORA_EGITIM_KURULUM.bat` — Kohya_ss LoRA eğitimi (~20 GB)

Toplam: ~250 GB disk, 2-4 saat süre.

### Seçenek B — Adım Adım

Daha kontrollü kurulum için menüden tek tek çalıştırın:
- **[2]** Sadece ComfyUI'yi kur, önce dene
- **[3]** Sonra istediğiniz modelleri indir
- **[4]** LoRA eğitimini istiyorsanız en son bunu kur

---

## 4. Dahil Edilen Modeller ve Lisansları

### Checkpoint Modelleri (`models/checkpoints/`)

| Model | Tür | Boyut | Ticari | NSFW | Not |
|-------|-----|-------|--------|------|-----|
| Juggernaut XL v9 | SDXL | 7 GB | ✅ | ✅ | Fotogerçekçi, genel amaçlı. En dengeli seçim |
| Pony Diffusion V6 XL | SDXL | 7 GB | ✅ | ✅ | Anime, karakter, NSFW konusunda üstün |
| Illustrious XL v0.1 | SDXL | 7 GB | ✅ | ✅ | Modern anime/illüstrasyon |
| RealVisXL V4 | SDXL | 7 GB | ✅ | ✅ | Portre ve fotogerçekçi |
| Flux.1 Schnell FP8 | Flux | 12 GB | ✅ | ⚠️ | Apache 2.0 — ticari serbest. NSFW sınırlı |

**Flux.1 Dev NEDEN YOK:** Non-commercial research lisansı var. Ticari kullanıma Black Forest Labs'tan ayrı lisans gerekir. Siz ticari kullanacağınız için Schnell'i (Apache 2.0) seçtim.

### Video Modelleri (`models/diffusion_models/`)

| Model | Tür | Boyut | Not |
|-------|-----|-------|-----|
| HunyuanVideo FP8 | Text-to-Video | 13 GB | Tencent, en iyi açık kaynak T2V. 720p, 5 saniye |
| LTX-Video 0.9.1 | T2V + I2V | 9 GB | Hızlı, gerçek zamanlıya yakın |
| Wan 2.1 I2V 14B | Image-to-Video | 28 GB | Apache 2.0. En iyi görsel-videoya dönüştürme |

### Yardımcı Modeller

- **VAE:** SDXL VAE, Flux VAE
- **Text Encoders:** T5-XXL FP8, CLIP-L (Flux için)
- **Upscaler:** 4x-UltraSharp, 4x-RealESRGAN, 4x-NMKD-Siax
- **ControlNet:** Union SDXL Promax (canny, depth, openpose, tile — hepsi tek dosyada)
- **IP-Adapter:** Plus SDXL, FaceID SDXL
- **Face/Body Detection:** face_yolov8m, hand_yolov8s, person_yolov8m-seg
- **Face Restore:** GFPGAN v1.4, CodeFormer
- **ReActor:** inswapper_128.onnx (face swap)
- **Segmentation:** SAM ViT-B

---

## 5. Workflow Dosyaları

`workflows/` klasöründe 6 adet hazır şablon bulacaksınız. Kullanmak için:

1. ComfyUI açıkken workflow `.json` dosyasını tarayıcıya **sürükle-bırak** yapın
2. Parametreleri değiştirin (prompt, seed vs.)
3. **Queue Prompt** butonuna basın

| Dosya | Açıklama | Süre (4090) |
|-------|----------|-------------|
| `01_SDXL_Fotogercekci.json` | Juggernaut XL ile fotogerçekçi görseller | ~8 sn/görsel |
| `02_Pony_Anime_NSFW.json` | Pony V6 ile anime + NSFW (score tag'leri dahil) | ~6 sn/görsel |
| `03_Flux_Schnell_Ticari.json` | Flux Schnell (4 step, ticari serbest) | ~3 sn/görsel |
| `04_Upscale_FaceDetail.json` | 4x upscale + yüz detaylandırma | ~15 sn/görsel |
| `05_Hunyuan_Video_T2V.json` | HunyuanVideo text-to-video | ~4-8 dk/video |
| `06_ReActor_FaceSwap.json` | Yüz değiştirme (sahip olduğunuz yüzlerle) | ~5 sn/görsel |

### Pony V6 Prompt Sistemi (Önemli)

Pony V6 özel "score tag"ler ister. Pozitif prompt'ta **mutlaka** başa ekleyin:
```
score_9, score_8_up, score_7_up, source_anime, [senin prompt'un]
```

Negatif prompt'a:
```
score_6, score_5, score_4, source_pony, source_furry
```

NSFW için `rating_explicit` veya `rating_safe` ekleyebilirsiniz.

---

## 6. Klasör Yapısı

```
D:\__sistem__\ProgramFiles\ComfyUi\
├── ComfyUI\
│   ├── main.py
│   ├── venv\                    (Python sanal ortam)
│   ├── custom_nodes\            (15+ eklenti)
│   ├── models\
│   │   ├── checkpoints\         ← Yeni modelleri (SDXL/Pony/vs.) buraya at
│   │   ├── loras\               ← LoRA dosyaları buraya
│   │   ├── vae\
│   │   ├── controlnet\
│   │   ├── upscale_models\
│   │   ├── embeddings\          ← Textual inversion
│   │   ├── ipadapter\
│   │   ├── clip_vision\
│   │   ├── diffusion_models\    ← Video modelleri
│   │   ├── clip\                ← Text encoders
│   │   ├── insightface\         ← Face swap modelleri
│   │   ├── facerestore_models\
│   │   └── ultralytics\
│   ├── input\                   ← Yüklediğiniz resimler
│   └── output\                  ← Üretilen görseller/videolar buraya kaydolur
├── kohya_ss\                    (LoRA eğitim aracı)
├── ComfyUI_Baslat.bat
└── KOHYA_BASLAT.bat
```

---

## 7. Günlük Kullanım

### Başlatma

`3_COMFYUI_BASLAT.bat` dosyasına çift tıklayın. Bu RTX 4090 için optimize edilmiş bayraklarla açılır:
- `--highvram` — 24 GB VRAM'i tam kullan
- `--fast` — FP16 hızlandırma (RTX 40 serisine özel)
- `--use-pytorch-cross-attention` — Modern attention

Tarayıcı: `http://127.0.0.1:8188`

### Kapatma

Başlatma penceresini kapatın veya terminalde `Ctrl+C`.

### Güncelleme

Haftada bir `5_GUNCELLE.bat` çalıştırın. Hem ComfyUI'yi hem de tüm custom node'ları günceller.

---

## 8. LoRA Eğitimi (Kohya_ss)

Kendi karakterinizi, stilinizi veya kıyafetinizi eğitmek için:

1. `KOHYA_BASLAT.bat` ile aracı açın → `http://127.0.0.1:7860`
2. **Dreambooth LoRA** sekmesi
3. Eğitim verisi hazırlığı:
   - 15-30 adet kaliteli fotoğraf (farklı açı, ışık, kıyafet)
   - Hepsi aynı kişi/obje olmalı
   - 1024x1024 (SDXL için) veya 512x512 (SD 1.5 için)
   - Her fotoğraf için `.txt` dosyası (açıklama, tag'ler)
4. Base model: `juggernautXL_v9.safetensors` (karakter için) veya `ponyDiffusionV6XL.safetensors` (anime için)
5. Öğrenme hızı: 0.0001 (SDXL için), 0.0005 (SD 1.5 için)
6. Network dim: 32, alpha: 16 (dengeli)
7. Epoch: 10-15
8. **Start training**

RTX 4090'da eğitim süresi: ~30-90 dakika.

Çıkan `.safetensors` dosyasını `ComfyUI\models\loras\` klasörüne atın, ComfyUI'de kullanmaya başlayın.

### LoRA ComfyUI'de Kullanımı

Workflow'a `LoraLoader` node'u ekleyin:
- CheckpointLoaderSimple → LoraLoader → KSampler'a model bağlayın
- Strength: 0.7-1.0 arası (genelde 0.8)
- Prompt'a eğittiğiniz trigger word'ü eklemeyi unutmayın

---

## 9. Ek Model İndirme

Paketteki modeller başlangıç için yeterli. Daha fazlası için:

### Civitai (en büyük NSFW + anime kaynağı)

- https://civitai.com
- Ücretsiz hesap açın (NSFW görmek için hesap + ayarları açın)
- Checkpoint/LoRA/Embedding indirip uygun klasöre atın
- Model sayfasında **"Commercial Use"** kısmını kontrol edin:
  - "Sell images" ✅ = Ticari satılabilir
  - "Sell merch" ✅ = Baskı/ürün olarak satılabilir
  - "Rent" / "None" = Ticari serbest değil

### HuggingFace

- https://huggingface.co/models
- Teknik/akademik ağırlıklı, lisanslar model kartında yazar

### Popüler Ek Önerileri (Ticari + NSFW uyumlu)

- **Realistic:** epiCRealism XL, RealVisXL V5, ZavyChromaXL
- **Anime:** AutismMix SDXL, WAI-NSFW Illustrious
- **LoRA siteleri:** Civitai'de "Commercial Use ✅" filtresi uygulayın

---

## 10. Sorun Giderme

| Problem | Çözüm |
|---------|-------|
| "Python not found" | PATH'e Python eklenmemiş. Python'u kaldırıp yeniden kurun, "Add to PATH" işaretleyin, PC'yi yeniden başlatın |
| "CUDA out of memory" | `--lowvram` flag ile başlatın; yüksek çözünürlükte tile kullanın |
| "Import error" custom node'da | `1_ANA_KURULUM.bat` içindeki bağımlılık kurulumu bölümünü yeniden çalıştırın |
| ReActor çalışmıyor | `pip install insightface==0.7.3 onnxruntime-gpu` manuel çalıştırın |
| Video modelleri yavaş | `--fast` ve `--use-sage-attention` deneyin; çözünürlüğü 512x320'e düşürün |
| Port 8188 kullanımda | `3_COMFYUI_BASLAT.bat`'ı düzenleyin, sonuna `--port 8189` ekleyin |
| Civitai'den indirme yavaş | Ücretsiz hesap açıp API key ile indirin; aria2c kullanın |
| Model "file not found" | Doğru klasörde olduğundan emin olun, ComfyUI menüden **Refresh** yapın |
| "Torch not compiled with CUDA" | PyTorch CPU sürümü kurulmuş. `venv`'de `pip uninstall torch torchvision` sonra CUDA sürümünü yeniden kurun |

---

## 11. Yasal ve Lisans Notları (Önemli)

### Model Lisansları

Her model farklı lisansla gelir. Ticari satıştan önce **mutlaka** kontrol edin:

- **Flux Dev** = Ticari LİSANS GEREKİR (pakette yok)
- **Flux Schnell** = Apache 2.0 (ticari serbest) ✅
- **SDXL** = CreativeML Open RAIL++ (ticari serbest) ✅
- **Pony V6** = Fair-AI Public License (ticari serbest) ✅
- **Illustrious** = Ticari serbest (model sayfasını kontrol edin)
- **HunyuanVideo** = Tencent lisansı: 100M aktif kullanıcı altında ticari serbest ✅
- **LTX-Video** = RAIL-M (ticari serbest) ✅
- **Wan 2.1** = Apache 2.0 ✅

### Türkiye Yasal Durum (Bilgi amaçlı, hukuki tavsiye değil)

- NSFW içerik **üretimi** Türkiye'de yasak değil
- NSFW içerik **dağıtımı/satışı** 5651 sayılı kanun kapsamında sınırlı
- Türkiye'den yetişkin içerik satan siteler yasadışı sayılır
- Yurtdışı platformlara (Fanvue, Patreon, OnlyFans, Civitai, Rule34) içerik satışı bölgenize göre değişir
- Vergi: Yurtdışından gelir elde ediyorsanız serbest meslek kazancı beyanı gerekir

### Risk Uyarıları

- **Gerçek kişi benzerliği:** Ünlülerin veya izinsiz kişilerin yüzünü/bedenini kullanmak çoğu ülkede yasadışı (deepfake yasaları, kişilik hakları)
- **Yaş:** Herhangi bir çocuk/genç benzeri NSFW içerik **kesinlikle yasak** ve model yapımcıları tarafından da yasaklı
- **Ticari satışta** her platformun Hizmet Şartlarını okuyun (Fanvue NSFW izin verir, Patreon sınırlı, Stripe/PayPal NSFW'yi askıya alır)
- **Model satışı:** Pony/Illustrious türev model satarken base lisansı kontrol edin
- **Üretilen içeriğin telif hakkı** ABD'de operatörünün (sizin) olabilir, AB'de tartışmalı — Civitai/Patreon koyuyor, kanıt zinciri tutun (prompt, seed, model)

### Güvenli Kullanım Önerisi

1. Her model için lisans dosyasını (`LICENSE`) saklayın
2. Ürettiğiniz içeriğin prompt + model + seed bilgilerini kayıt altına alın (kanıt)
3. Sadece izin verdiğiniz kendi fotoğraflarınızla LoRA eğitin
4. Şüpheli durumda avukata danışın, bu kılavuz hukuki tavsiye değildir

---

## Son Notlar

Bu paket size profesyonel ticari içerik üretim altyapısını kuruyor. RTX 4090 ile:
- Günde binlerce SDXL/Pony görsel üretebilirsiniz
- Birkaç yüz video klibi (5-10 saniye) üretebilirsiniz
- Kendi karakter LoRA'nızı 1 saatte eğitebilirsiniz

**Başlangıç önerisi:** Önce `01_SDXL_Fotogercekci.json` workflow'u ile bir şeyler üretin, sistemi tanıyın. Sonra Pony'ye geçin, LoRA eğitin. Video en son, çünkü en çok kaynak ister.

İyi üretimler!
