Metadata-Version: 2.4
Name: synth-authenticator
Version: 2.0.0
Summary: AI Forensic Engine — multi-detector ensemble for AI-generated text and image authentication.
Author-email: Khushaal <khushaal@example.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/khushalv21/SYNTH
Project-URL: Repository, https://github.com/khushalv21/SYNTH
Project-URL: Issues, https://github.com/khushalv21/SYNTH/issues
Keywords: ai,authenticator,ocr,cli,nlp,content-detection,deepfake,image-forensics,ensemble,forensics,vision-transformer
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer<1,>=0.12
Requires-Dist: rich<16,>=13
Requires-Dist: easyocr<2,>=1.7
Requires-Dist: opencv-python-headless<5,>=4.9
Requires-Dist: pypdfium2<5,>=4.25
Requires-Dist: torch<3,>=2.2
Requires-Dist: transformers<6,>=4.40
Requires-Dist: Pillow>=10.0
Requires-Dist: python-dotenv<2,>=1.0
Requires-Dist: httpx<1,>=0.27
Requires-Dist: certifi>=2024.2
Provides-Extra: fast
Requires-Dist: xgboost>=2.0; extra == "fast"
Requires-Dist: scipy>=1.12; extra == "fast"
Requires-Dist: joblib>=1.3; extra == "fast"
Provides-Extra: vision
Requires-Dist: scikit-image>=0.22; extra == "vision"
Requires-Dist: torchvision>=0.17; extra == "vision"
Provides-Extra: full
Requires-Dist: xgboost>=2.0; extra == "full"
Requires-Dist: scipy>=1.12; extra == "full"
Requires-Dist: joblib>=1.3; extra == "full"
Requires-Dist: scikit-image>=0.22; extra == "full"
Requires-Dist: torchvision>=0.17; extra == "full"
Requires-Dist: open-clip-torch>=2.24; extra == "full"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: pre-commit>=3.7; extra == "dev"
Dynamic: license-file

```text
  ███████╗██╗   ██╗███╗   ██╗████████╗██╗  ██╗
  ██╔════╝╚██╗ ██╔╝████╗  ██║╚══██╔══╝██║  ██║
  ███████╗ ╚████╔╝ ██╔██╗ ██║   ██║   ███████║
  ╚════██║  ╚██╔╝  ██║╚██╗██║   ██║   ██╔══██║
  ███████║   ██║   ██║ ╚████║   ██║   ██║  ██║
  ╚══════╝   ╚═╝   ╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝
```

<p align="center">
  <a href="https://github.com/khushalv21/SYNTH"><img src="https://img.shields.io/github/stars/khushalv21/SYNTH?style=social" alt="Stars"></a>
  <a href="https://github.com/khushalv21/SYNTH/blob/main/LICENSE"><img src="https://img.shields.io/github/license/khushalv21/SYNTH.svg" alt="License"></a>
  <img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+">
</p>

<p align="center">
  <a href="#installation">Installation</a> •
  <a href="#quick-start">Quick Start</a> •
  <a href="#cli-reference">CLI Reference</a> •
  <a href="#configuration">Configuration</a>
</p>

<p align="center">
  <strong>Catch AI fakes in seconds.</strong><br>
  <em>Synth is a tool that tells you if an image or document was created by an AI or a human.</em>
</p>

---

## What is Synth?

**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.

### Features

- 🔍 **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.

---

## Installation

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

> [!NOTE]
> Since the name `synth` was already taken on PyPI, the package is published under the name **`synth-authenticator`**.

Run the following command to install using `pip`:

```bash
pip install synth-authenticator
```

Alternatively, you can install it from source:

```bash
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.*


---

## Quick Start

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

```bash
synth my_picture.png
synth my_document.pdf
```

### Choose your investigation depth

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

```bash
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
```

### Scan a whole folder

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

```bash
synth ./my_documents_folder/
```

---

## CLI Reference

| Command | Description |
|---|---|
| `synth <file>` | Analyze a file (Image or PDF) |
| `synth <folder>/` | Analyze an entire folder |
| `synth models` | See all the internal AI models doing the work |
| `synth help` | Show the help menu |

**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.

---

## Configuration & Advanced Use

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](docs/ARCHITECTURE.md) and [API Guide](docs/UNIVERSAL_API_GUIDE.md).

---

## License

MIT — see [LICENSE](LICENSE) for details.
