ShadowForge-models / README.md
neil1145's picture
Upload README.md with huggingface_hub
7fa9a26 verified
---
license: other
tags:
- shadowforge
- comfyui
- flux
- wan
- horror
- video-generation
- image-generation
---
# ShadowForge Models
Pre-packaged model weights for [ShadowForge](https://github.com/neil1145/ShadowForge) β€” an AI horror content generation pipeline.
All models are selected, quantized, and tested for **16GB VRAM** GPUs (RTX 4060 Ti 16GB, RTX 5060 Ti, etc.).
## Models Included
### Image Generation (Flux.1 Dev)
| File | Size | Description |
|------|------|-------------|
| `diffusion_models/flux1-dev-Q5_0.gguf` | ~7.8 GB | Flux.1 Dev UNET, GGUF Q5 quantized |
| `text_encoders/clip_l.safetensors` | ~235 MB | CLIP-L text encoder |
| `text_encoders/t5xxl_fp8_e4m3fn.safetensors` | ~4.6 GB | T5-XXL text encoder, fp8 |
| `vae/ae.safetensors` | ~320 MB | Flux autoencoder |
### Video Generation (Wan 2.1 I2V)
| File | Size | Description |
|------|------|-------------|
| `diffusion_models/wan2.1_i2v_480p_14B_fp8_e4m3fn.safetensors` | ~16 GB | Wan 2.1 I2V 14B, fp8 |
| `text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors` | ~6.3 GB | UMT5-XXL encoder, fp8 |
| `clip_vision/clip_vision_h.safetensors` | ~1.2 GB | CLIP Vision H encoder |
| `vae/wan_2.1_vae.safetensors` | ~243 MB | Wan 2.1 video VAE |
**Total: ~37 GB**
## Quick Download
```bash
# Clone ShadowForge and download all models
git clone https://github.com/neil1145/ShadowForge.git
cd ShadowForge
pip install -r requirements.txt
python scripts/download_models.py --models-dir /path/to/comfyui/models
```
Or download individual files:
```bash
pip install huggingface_hub
huggingface-cli download neil1145/ShadowForge-models --local-dir /path/to/comfyui/models
```
## Directory Structure
Files should be placed in your ComfyUI models directory:
```
models/
β”œβ”€β”€ clip_vision/
β”‚ └── clip_vision_h.safetensors
β”œβ”€β”€ diffusion_models/
β”‚ β”œβ”€β”€ flux1-dev-Q5_0.gguf
β”‚ └── wan2.1_i2v_480p_14B_fp8_e4m3fn.safetensors
β”œβ”€β”€ text_encoders/
β”‚ β”œβ”€β”€ clip_l.safetensors
β”‚ β”œβ”€β”€ t5xxl_fp8_e4m3fn.safetensors
β”‚ └── umt5_xxl_fp8_e4m3fn_scaled.safetensors
└── vae/
β”œβ”€β”€ ae.safetensors
└── wan_2.1_vae.safetensors
```
## VRAM Requirements
These models are designed to run **one at a time** on 16GB VRAM:
- **Flux image generation:** ~10 GB peak VRAM
- **Wan video generation:** ~14 GB peak VRAM
ShadowForge's VRAMManager handles automatic model swapping β€” it evicts the current model before loading the next one.
## License
Individual models retain their original licenses:
- Flux.1 Dev: [FLUX.1-dev Non-Commercial License](https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/main/LICENSE.md)
- Wan 2.1: [Apache 2.0](https://huggingface.co/Wan-AI/Wan2.1-I2V-14B-480P)
- CLIP/T5 encoders: Various open licenses
This repo is a convenience bundle. Check individual model pages for license details.