A face-swap CLI with a CI-like job queue
It turns face swaps and lip-syncs into queued, retryable batch jobs instead of one-off scripts.

What it does FaceFusion is a Python-based face manipulation tool—face swaps and lip-sync, judging by its own topics—that you control from the terminal. Rather than a simple script, it behaves like a lightweight job scheduler: you draft multi-step work, queue it, run batches, and retry failures without rewriting commands.
The interesting bit Most media tools are one-shot; this one treats face manipulation like a render farm. The CLI lets you remix existing steps, insert new ones, and manage a full queue of drafted, queued, and failed jobs. That structure is overkill for a single clip, but it makes sense if you are processing volumes.
Key highlights
- Headless, batch, and benchmark modes for automated or server-side workflows.
- Built-in job lifecycle: create, submit, remix, retry, and purge steps.
- OpenRAIL-AS license, which adds responsible-use restrictions uncommon in open-source media tooling.
- Standalone installers for Windows and macOS if you want to skip manual terminal setup.
Caveats
- The README is heavy on CLI syntax and light on what the actual manipulation does; you will need the external docs for specifics.
- The project describes itself as “industry leading,” though the README offers no benchmarks or comparisons to back that up.
- Setup is explicitly flagged as “not recommended for beginners.”
Verdict Worth a look if you need to batch-process face swaps or lip-syncs from the command line. If you just want to try a single face swap on your laptop, the job-queue rigmarole is probably more bureaucracy than you need.
Frequently asked
- What is facefusion/facefusion?
- It turns face swaps and lip-syncs into queued, retryable batch jobs instead of one-off scripts.
- Is facefusion open source?
- Yes — facefusion/facefusion is an open-source project tracked on heatdrop.
- What language is facefusion written in?
- facefusion/facefusion is primarily written in Python.
- How popular is facefusion?
- facefusion/facefusion has 29.4k stars on GitHub and is currently holding steady.
- Where can I find facefusion?
- facefusion/facefusion is on GitHub at https://github.com/facefusion/facefusion.