git404hub

what is fawkes fr?

shawn-shan/fawkes — explained in plain English

Analysis updated 2026-06-26

5,527PythonAudience · generalComplexity · 2/5Setup · easy

tl;dr

Fawkes adds invisible modifications to your face photos so that AI facial recognition systems cannot identify you from those images, while the photos still look completely normal to any human viewer.

vibe map

mindmap
  root((repo))
    What it does
      Invisible face edits
      Defeats recognition AI
      Privacy protection
    How it works
      Cloaks photos
      Fools training data
      Humans see no change
    Interfaces
      Command line
      Desktop app Mac Windows
    Protection Modes
      Low moderate high
      Higher = stronger

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run your photos through Fawkes before posting to social media to stop facial recognition services from identifying you.

VIBE 2

Batch-process a folder of portrait photos to apply privacy cloaking before uploading them anywhere online.

VIBE 3

Use the Mac or Windows desktop app to cloak photos without touching the command line.

what's the stack?

PythonPyPI

how it stacks up fr

shawn-shan/fawkesfanghua-yu/supircog-creators/red-discordbot
Stars5,5275,5295,532
LanguagePythonPythonPython
Setup difficultyeasyhardmoderate
Complexity2/55/53/5
Audiencegeneralresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Processing takes about 60 seconds per image on CPU, a GPU speeds this up significantly for large batches.

in plain english

Fawkes is a privacy protection tool built by researchers at the University of Chicago. Its purpose is to make small, invisible changes to photos of your face so that facial recognition systems cannot correctly identify you. The changes are so subtle that a human looking at the photo would not notice anything different, but machine learning models that try to learn your face from those photos end up with a distorted picture of who you are. The project was published as an academic paper at USENIX Security 2020, one of the top computer security conferences. The researchers call these invisible edits "cloaks." When a cloaked photo gets fed into a face recognition training pipeline, the system memorizes a version of your face that does not match what you actually look like. Later, when that system tries to recognize your real, uncloaked face, it fails. You run Fawkes from the command line, pointing it at a directory of images. There are three protection modes: low, mid, and high. Higher modes add more distortion and offer stronger protection but are more visible. Processing takes about 60 seconds per image on a regular laptop CPU, and considerably faster on a machine with a GPU. The output is a new set of images in your chosen format, such as PNG or JPG, with the cloaking applied. Installation is straightforward: it is available on PyPI, the standard Python package index, so you can install it with one command. A desktop application for Mac and Windows is also available on the project website for people who prefer not to use the command line. The code is intended for personal privacy protection or academic research. If you are a non-technical person, the practical use case is this: before uploading photos of yourself to social media or any public site, you run them through Fawkes first. The photos look normal to anyone viewing them, but any service that tries to train a facial recognition model on your images will end up unable to recognize you in real life.

prompts (copy fr)

prompt 1
How do I install Fawkes with pip and batch-process a folder of portrait photos to apply privacy cloaking before uploading them?
prompt 2
Run Fawkes on my photos in high-protection mode and explain what changes in the output images compared to the originals.
prompt 3
Explain what Fawkes' three protection modes (low, mid, high) actually change in a photo and when I should use each one.

Frequently asked questions

what is fawkes fr?

Fawkes adds invisible modifications to your face photos so that AI facial recognition systems cannot identify you from those images, while the photos still look completely normal to any human viewer.

What language is fawkes written in?

Mainly Python. The stack also includes Python, PyPI.

How hard is fawkes to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is fawkes for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.