VACEPhantomCausvid / README.md
hdtrnk's picture
Upload README.md
e83364d verified
# 📖 Wan2.1 VACE + Phantom Causvid (Finetune)
**Author / Creator:** [Inner_Reflections_AI](https://civitai.com/articles/17908/guide-wan-vace-phantom-merge-an-inner-reflections-guide)
**Packaged for WanGP by:** [hdtrnk](https://huggingface.co/hdtrnk)
---
## 🔹 About This Finetune
This is a **custom merge of Wan 2.1 VACE and Phantom**, created by **Inner_Reflections_AI** and purified to **FP16** for compatibility with **WanGP**.
- **Architecture:** `vace_14B`
- **Mode:** Image/Video conditioning with multi-reference support
- **Multi-Image:** Optimized for 2–4 image references in WanGP custom UI
- **Variants:** Both **FP16** and **INT8** versions provided
---
## 🔹 Files
- [Wan2.1_VACE_Phantom_Causvid_fp16_pure.safetensors](https://huggingface.co/hdtrnk/VACEPhantomCausvid/blob/main/Wan2.1_VACE_Phantom_Causvid_fp16_pure.safetensors)
- [Wan2.1_VACE_Phantom_Causvid_quanto_bf16_int8_pure.safetensors](https://huggingface.co/hdtrnk/VACEPhantomCausvid/blob/main/Wan2.1_VACE_Phantom_Causvid_quanto_bf16_int8_pure.safetensors)
---
## 🔹 Usage in WanGP
Place the JSON definition file into:
```
app/finetunes/vace_phantom_causvid.json
```
Sample finetune entry:
```json
{
"model": {
"name": "VACE Phantom Causvid 14B",
"architecture": "vace_14B",
"description": "VACE-first UI with Phantom multi-image references enabled. Causvid merge, purified FP16 for clean loading & optional INT8 quantization.",
"URLs": [
"https://huggingface.co/hdtrnk/VACEPhantomCausvid/blob/main/Wan2.1_VACE_Phantom_Causvid_fp16_pure.safetensors",
"https://huggingface.co/hdtrnk/VACEPhantomCausvid/blob/main/Wan2.1_VACE_Phantom_Causvid_quanto_bf16_int8_pure.safetensors"
],
"modules": [],
"auto_quantize": false
}
}
```
---
## 🔹 Notes
- This is an **experimental finetune**. You may need to tweak **steps**, **guidance scale**, and **reference image setup** for best results.
- Works best with **multi-image prompts** where identities are clearly separated (e.g., “Character A on left, Character B on right”).
- If you encounter **dropdown errors** (`Value: on is not in the list...`), refresh the UI and reselect options.
---
## 🔹 Credits
- **Merge & Guide:** [Inner_Reflections_AI](https://civitai.com/articles/17908/guide-wan-vace-phantom-merge-an-inner-reflections-guide)
- **Light JSON Packaging & Uploads:** [hdtrnk](https://huggingface.co/hdtrnk)