← all repositories
facefusion/facefusion

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.

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

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.

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