README.md

metadata

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.

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
Video VAE	Kijai/LTX2.3_comfy
Text encoder + scheduler	Lightricks/LTX-Video
Distill LoRA	SulphurAI/Sulphur-2-base
BFS head-swap LoRA	Alissonerdx/BFS-Best-Face-Swap-Video

Logs

Container logs (runtime output):

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):

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 for the complete terms.