README.md

---
title: BFS Best Face Swap Video
emoji: 🎭
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: "5.7.1"
app_file: app.py
pinned: true
license: other
hardware: a100-large
suggested_hardware: a100-large
---

# BFS — Best Face Swap Video

Hugging Face Space for the **V3 persistent-template** head-swap workflow built on [LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3).

## How it works

1. Upload a **guide video** (the body/performance you want to keep)
2. Upload a **reference face image** (the identity to transfer)
3. Write or paste a **text prompt** in the structured format below
4. Click **Generate**

The reference face is composited into a green chroma side-strip that persists across all frames during diffusion, giving the model continuous identity conditioning. The strip is cropped from the final output automatically.

### Prompt format

```
head_swap:
FACE: <detailed identity description from the reference image>
ACTION: <performance description from the guide video — body, clothing, movement only>
```

**Example:**
```
head_swap:
FACE: Female, fair skin, approximately 25-30 years old, long wavy auburn hair,
bright green eyes, no facial hair, smooth skin, small silver earrings.

ACTION: A person in a grey hoodie walks toward the camera in an indoor hallway,
holds a coffee cup in their right hand, glances to the left.
```

## Models used

| Component | Source |
|-----------|--------|
| Transformer (22B, FP8 mixed) | [SulphurAI/Sulphur-2-base](https://huggingface.co/SulphurAI/Sulphur-2-base) |
| Video VAE | [Kijai/LTX2.3_comfy](https://huggingface.co/Kijai/LTX2.3_comfy) |
| Text encoder + scheduler | [Lightricks/LTX-Video](https://huggingface.co/Lightricks/LTX-Video) |
| Distill LoRA | [SulphurAI/Sulphur-2-base](https://huggingface.co/SulphurAI/Sulphur-2-base) |
| BFS head-swap LoRA | [Alissonerdx/BFS-Best-Face-Swap-Video](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap-Video) |

## Logs

**Container logs** (runtime output):
```bash
curl -N \
     -H "Authorization: Bearer $HF_TOKEN" \
     "https://huggingface.co/api/spaces/ismailkattakath/BFS-Best-Face-Swap-Video/logs/run"
```

**Build logs** (Docker build output):
```bash
curl -N \
     -H "Authorization: Bearer $HF_TOKEN" \
     "https://huggingface.co/api/spaces/ismailkattakath/BFS-Best-Face-Swap-Video/logs/build"
```

## Ethical use

This tool is intended for **filmmakers, VFX artists, and researchers**.
You must have explicit consent from any person whose likeness you process.
See the [full model card](https://huggingface.co/Alissonerdx/BFS-Best-Face-Swap-Video) for the complete terms.