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.

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-runandbatch-runmodes 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.