SYNTH

  ███████╗██╗   ██╗███╗   ██╗████████╗██╗  ██╗
  ██╔════╝╚██╗ ██╔╝████╗  ██║╚══██╔══╝██║  ██║
  ███████╗ ╚████╔╝ ██╔██╗ ██║   ██║   ███████║
  ╚════██║  ╚██╔╝  ██║╚██╗██║   ██║   ██╔══██║
  ███████║   ██║   ██║ ╚████║   ██║   ██║  ██║
  ╚══════╝   ╚═╝   ╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝

Installation • Quick Start • CLI Reference • Configuration

Catch AI fakes in seconds.
Synth is a tool that tells you if an image or document was created by an AI or a human.

Synth acts like a digital detective. Whenever you encounter a picture, a PDF, or text and wonder, "Did a computer make this?", Synth gives you the answer.

Instead of relying on just one check, Synth uses a team of specialized AI models. Each model looks at the file from a different angle, and they all vote to give you a highly accurate, final verdict. Everything runs safely and privately on your own computer.

• 🔍 Reads Anything — Just point it at an image or a PDF. It extracts text and analyzes images automatically.
• 🤖 Team of Experts — Uses an ensemble of state-of-the-art models that vote together to catch fakes.
• ⚡ Adjustable Depth — Choose between a quick glance or a deep, forensic investigation.
• 🍎 Works Anywhere — Runs smartly on Mac, Windows, and Linux with automatic hardware acceleration.
• 🔒 100% Private — No cloud uploads needed. Your files stay perfectly private.

Getting started is simple. You can install Synth directly from PyPI.

Run the following command to install using pip:

pip install synth-authenticator

Alternatively, you can install it from source:

git clone https://github.com/khushalv21/SYNTH.git
cd SYNTH
pip install .

Note: Synth will automatically detect your system's hardware to run as fast as possible. The first time you run it, it will download the necessary AI models.

Synth is designed to be effortless. Just type synth followed by the file you want to check:

synth my_picture.png
synth my_document.pdf

You can tell Synth how closely you want it to look using "Profiles":

synth my_picture.png --profile fast       # A quick check
synth my_picture.png --profile balanced   # The normal check (recommended)
synth my_picture.png --profile forensic   # A deep, thorough investigation

Have a lot of files? You can scan a whole directory at once:

synth ./my_documents_folder/

Tip: If you only want to extract the text without running an AI check, you can use the --no-text flag to toggle the text panel.

For developers or those needing advanced setup (like plugging in external APIs such as OpenAI or Anthropic), simply create a .env file in the directory. You can use the provided .env.example as a template.

For full technical documentation, see the Architecture Guide and API Guide.

MIT — see LICENSE for details.