flux-klein / README.md
AEmotionStudio's picture
Add mirror README with usage instructions
bf0a5c0 verified
---
license: apache-2.0
pipeline_tag: image-to-image
tags:
- flux
- inpainting
- image-editing
- diffusion
- safetensors
base_model: black-forest-labs/FLUX.2-klein-4B
---
# FLUX Klein 4B — AEmotionStudio Mirror
**Mirror of [black-forest-labs/FLUX.2-klein-4B](https://huggingface.co/black-forest-labs/FLUX.2-klein-4B)** for use with [ComfyUI-FFMPEGA](https://github.com/AEmotionStudio/ComfyUI-FFMPEGA).
## About
FLUX Klein is a 4-billion parameter image editing and generation model from [Black Forest Labs](https://blackforestlabs.ai/). It supports:
- **Object removal** — erase unwanted objects from images/video frames
- **Text-guided editing** — change hair color, swap backgrounds, modify clothing, etc.
- **Inpainting** — fill masked regions with contextually appropriate content
This mirror provides the same bf16 safetensors weights as the upstream repo, hosted on AEmotionStudio infrastructure for supply-chain resilience.
## Model Details
| Property | Value |
|----------|-------|
| **Architecture** | FLUX (Rectified Flow Transformer) |
| **Parameters** | 4B |
| **Precision** | bf16 (bfloat16) |
| **Total Size** | ~15 GB |
| **License** | [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) |
| **Source** | [black-forest-labs/FLUX.2-klein-4B](https://huggingface.co/black-forest-labs/FLUX.2-klein-4B) |
### Files
| Component | File | Size |
|-----------|------|------|
| Transformer | `transformer/diffusion_pytorch_model.safetensors` | 7.4 GB |
| Text Encoder (T5-XXL) | `text_encoder/model-00001-of-00002.safetensors` | 4.7 GB |
| Text Encoder (T5-XXL) | `text_encoder/model-00002-of-00002.safetensors` | 2.9 GB |
| VAE | `vae/diffusion_pytorch_model.safetensors` | 160 MB |
| Tokenizer, configs | `tokenizer/`, `scheduler/`, `*.json` | < 15 MB |
## Usage with ComfyUI-FFMPEGA
This model is **auto-downloaded** when you use the `auto_mask` skill with `effect=remove` or `effect=edit` in [ComfyUI-FFMPEGA](https://github.com/AEmotionStudio/ComfyUI-FFMPEGA).
### Object Removal
Prompt the FFMPEGA Agent:
```
Remove the watermark
```
Or use the Effects Builder with SAM3 target + `remove` effect.
### Text-Guided Editing
Prompt the FFMPEGA Agent:
```
Change the hair to red
```
Or use `auto_mask` with `effect=edit` and `edit_prompt="change the hair to red"`.
### Manual Download
If auto-download is disabled, download all files and place them in:
```
ComfyUI/models/flux_klein/
```
## VRAM Requirements
- **Minimum**: ~8 GB (with aggressive CPU offloading)
- **Recommended**: ~13 GB (bf16/fp16, sequential CPU offload)
- GPUs without native bf16 support (pre-Ampere) automatically use fp16 at load time
## License
The model weights are licensed under **Apache 2.0** by Black Forest Labs. See [LICENSE.md](LICENSE.md) for full terms.
## Citation
```bibtex
@misc{flux2klein2025,
title={FLUX.2 Klein},
author={Black Forest Labs},
year={2025},
url={https://huggingface.co/black-forest-labs/FLUX.2-klein-4B}
}
```