# ComfyUI-FikoYT-Nodes

FikoYT custom nodes for ComfyUI — image / video / audio / character / utility.

Profesyonel, tam parametreli, auto-download'lı, birleştirilebilir node paketi. MVD'de yapılan her render iş akışını saf ComfyUI workflow'ları olarak yapın, başka projelerde kullanın, paylaşın.

## Kategoriler (50 node)

- **Image (15)** — Flux Loader / Sampler, Qwen Loader / Multi-Angle, SDXL Loader, PuLID v2, InstantID, IPAdapter v2, DWPose Extract, ControlNet Union, SAM2 Mask, Kontext Edit, Style Transfer, **Color Grade**, **Image Upscale**, **Image Inpaint**
- **Video (12)** — Wan T2V / I2V / S2V, LTX Loader / Distilled / Interpolate / Upscale, HunyuanVideo, InfiniteTalk, HuMo, Storyboard Concat, Video Grid
- **Audio (12)** — SongGen Loader / v2, F5-TTS, Edge TTS, **XTTS v2 (Coqui)**, Demucs Split, **Audio Separator (UVR-MDX)**, Whisper STT, Audio Trim / Concat, Master Audio, **MP3 → WAV**
- **Character (4)** — Character Bind, Character Unpack (FIKOYT_CHARACTER tipi), LoRA Stack Apply, Face Swap (Reactor + insightface fallback)
- **Utility (7)** — Aspect Preset, Seed Control, Prompt Builder, LoRA Picker, File Picker, Gallery Save, **LLM Prompt Assist (llama-cpp)**

## Opsiyonel Eksternal Node Bağımlılıkları

Bazı node'lar mevcut ComfyUI custom node'larını wrapper olarak çağırır. Yüklü değilse paket yine çalışır, sadece o node anlamlı hata mesajıyla çıkar.

- **ComfyUI_PuLID_Flux_ll** — PuLID v2 için
- **ComfyUI_InstantID** (cubiq) — InstantID için
- **ComfyUI_IPAdapter_plus** (cubiq) — IPAdapter v2 için
- **comfyui_controlnet_aux** — DWPose için
- **ComfyUI-segment-anything-2** (kijai) — SAM2 için
- **ComfyUI-HunyuanVideoWrapper** (kijai) — HunyuanVideo için
- **ComfyUI_SongGeneration** (smthemex) — SongGen v2 için
- **comfyui-reactor-node** (opsiyonel) — Face Swap için, yoksa insightface fallback

## Pip paketleri

`requirements.txt` minimum bağımlılıkları içerir. Audio node'ları ilk kullanımda anlamlı kurulum mesajı verir:

```
edge-tts     # FikoYTEdgeTTS
f5-tts       # FikoYTF5TTS
faster-whisper veya openai-whisper  # FikoYTWhisperSTT
demucs       # FikoYTDemucsSplit
```

## Kurulum

```bash
cd ComfyUI/custom_nodes
git clone https://github.com/fikoyt/ComfyUI-FikoYT-Nodes.git
ComfyUI/python_embeded/python.exe -m pip install -r ComfyUI-FikoYT-Nodes/requirements.txt
```

ComfyUI'yi yeniden başlatın. Menüde `FikoYT/` kategorisi görünecek.

## Auto-Download

Loader node'ları eksik modeli HuggingFace'den otomatik indirir. Modeller standart `ComfyUI/models/` alt klasörlerine yazılır (`checkpoints`, `loras`, `vae`, `clip`, `controlnet`, `insightface`, `sams`, `diffusion_models`).

## Birleştirilebilirlik

Tüm I/O standart ComfyUI tipleri (IMAGE, LATENT, MODEL, CLIP, VAE, CONDITIONING, AUDIO, MASK). rgthree, KJNodes, comfyui-controlnet-aux gibi paketlerle native çalışır. Custom tipler (`FIKOYT_CHARACTER`, `FIKOYT_LORA_STACK`) opsiyonel — bypass edip standart node'larla aynı sonuç alınabilir.

## Örnek Workflow'lar

`examples/` klasöründe JSON'lar — ComfyUI'ye sürükle bırak:

- `examples/flux_t2i.json` — Flux text-to-image
- `examples/wan_s2v.json` — Wan Sound-to-Video
- `examples/songgen_v2.json` — SongGen v2 müzik üretimi

## Lisans

MIT