← all repositories
facefusion/facefusion

Face-swapping CLI that treats deepfakes like CI pipelines

A Python toolkit for face manipulation built around job queues, remixable steps, and headless automation rather than one-off GUI wizardry.

facefusion
Velocity · 7d
+28
★ / day
Trend
steady
star history

What it does

FaceFusion is a command-line face manipulation platform — think face swaps, lip sync, and related deepfake techniques — that you drive via python facefusion.py with a surprisingly bureaucratic set of subcommands. It can run interactively, headlessly, or in batch mode, and it wraps operations in a job system where you draft, submit, queue, retry, and remix steps.

The interesting bit

Most face-swap tools chase slick UI demos; this one chases reproducibility. The job-step architecture — create, remix, insert, remove, submit, retry — treats face manipulation like a CI pipeline or render farm, which is either over-engineered or exactly what you need if you’re processing hundreds of videos overnight.

Key highlights

  • CLI-first with explicit headless-run and batch-run modes for automation
  • Job queue system with step-level remixing and retry logic
  • Separate Windows and macOS installers for the terminal-averse
  • OpenRAIL-AS license (the “please don’t do evil” AI license)
  • 28K+ stars suggests it’s the default choice in its category

Caveats

  • README warns installation “needs technical skills and is not recommended for beginners”
  • Actual capabilities (models, quality, speed) are barely mentioned in the README — you’ll need to read the external docs for anything beyond command syntax
  • No benchmarks or hardware requirements shown in the source provided

Verdict

Worth a look if you’re building an automated media pipeline or need batch face manipulation with audit-trail-like job tracking. Skip it if you want a one-click GUI or if you need to evaluate quality before investing setup time.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.