OpenSeek

Status Python FastAPI Chrome Extension License

๐Ÿ›ก๏ธ OpenSeek

Advanced Image-Only Deepfake & AI Generation Detection Tool



๐Ÿ“– Short Description

OpenSeek is a powerful, open-source forensic tool designed to help you instantly detect AI-generated images and deepfakes directly in your browser. Using a research-grade machine learning backend, it analyzes spatial inconsistencies, lighting mismatches, and AI artifacts to confidently tell you if an image is a deepfake manipulation, AI-generated (Midjourney, Stable Diffusion), or a genuine photograph.


โœจ Features


๐Ÿ“ธ Screenshots

(Add your screenshots here!)

Pro tip: Take a screenshot of the context menu and the popup showing a 99% Deepfake result, and drag-and-drop them into this section.


๐Ÿ› ๏ธ How It Works

  1. User Request: The user right-clicks an image in the browser and clicks โ€œAnalyze for Deepfakeโ€.
  2. Data Extraction: The Chrome Extension extracts the image data and sends it securely to the local backend.
  3. Forensic Pipeline: The backend runs the image through face detectors, spatial frequency analyzers, and an EfficientNet ensemble model
  4. Scoring: A final blended confidence score is calculated.
  5. UI Rendering: The result (Real vs. AI) is immediately passed back to the extension popup for the user to review.

๐Ÿ—๏ธ Architecture Diagram

(Add your architecture diagram image here or use the chart below!)

graph TD;
    A[Browser Extension] -->|Sends Image| B(FastAPI Backend);
    B --> C{Adversarial Purifier};
    C -->|Clean Image| D{Preprocessing};
    D -->|Face Crop| E[Biological & Facial Forensics];
    D -->|Full Image| F[ViT / EfficientNet Ensemble];
    D -->|Frequency| G[Spectral & DCT Analyzer];
    E --> H(Confidence Score & Attribution);
    F --> H;
    G --> H;
    H -->|Generates Forensic Report| A;

๐ŸŽฏ Accuracy

OpenSeekโ€™s custom ensemble has been tested against thousands of real and AI-generated images, achieving:

Because our backend analyzes Spatial Frequencies, DCT Grid Misalignments, and Physiological Physics, even heavily compressed or adversarially cloaked deepfakes cannot hide their generative artifacts.


๐Ÿ’ป Tech Stack


๐Ÿš€ Installation Guide

Step 1: Start the Backend (FastAPI)

You need Python 3.10+ installed on your computer.

  1. Open your terminal and navigate to the backend folder:
    cd backend
    
  2. Create and activate a virtual environment:
    # On Mac/Linux:
    python3 -m venv venv
    source venv/bin/activate
       
    # On Windows:
    python -m venv venv
    venv\Scripts\activate
    
  3. Install the required Python packages:
    pip install -r requirements.txt
    
  4. Pre-download the HuggingFace and local models:
    python download_models.py
    
  5. Start the server!
    uvicorn main:app --reload --port 8000
    

    Your backend is now running at http://localhost:8000.

Step 2: Install the Chrome Extension

  1. Open Google Chrome and go to chrome://extensions/ in your address bar.
  2. Turn on Developer mode using the toggle switch in the top right corner.
  3. Click the Load unpacked button in the top left.
  4. Select the extension folder from this repository.

๐ŸŽฎ Usage Guide

  1. Ensure the Python backend is actively running in your terminal.
  2. Go to any website with images (e.g., Twitter, Google Images, Reddit).
  3. Right-click on a suspect image and click โ€œAnalyze for Deepfakeโ€.
  4. The OpenSeek extension will instantly notify you if the image is real or AI-generated!

๐Ÿ“‚ Project Structure

OpenSeek/
โ”œโ”€โ”€ backend/                  # Python FastAPI Backend
โ”‚   โ”œโ”€โ”€ main.py               # Main API entry point
โ”‚   โ”œโ”€โ”€ models/               # ML Models (Image detectors)
โ”‚   โ”œโ”€โ”€ routers/              # API Route definitions
โ”‚   โ””โ”€โ”€ requirements.txt      # Python dependencies
โ”œโ”€โ”€ extension/                # Google Chrome Extension
โ”‚   โ”œโ”€โ”€ background.js         # Service worker (Context Menu)
โ”‚   โ”œโ”€โ”€ popup.html/.js        # Extension UI
โ”‚   โ””โ”€โ”€ manifest.json         # Manifest V3 configuration
โ”œโ”€โ”€ LICENSE                   # MIT License
โ””โ”€โ”€ README.md                 # This documentation

๐Ÿ”Œ API Endpoints

If you want to integrate OpenSeek into your own application, you can request the endpoints directly:

1. File Upload (Multipart Form)

POST /detect-image (or /analyze-image alias)

2. URL Scan (JSON)

POST /analyze-image-data


๐Ÿ—บ๏ธ Roadmap


๐Ÿค Contributing

Contributions, issues, and feature requests are welcome!

  1. Fork the Project.
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
  3. Commit your Changes (git commit -m 'Add some AmazingFeature').
  4. Push to the Branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

๐Ÿ“œ License

Distributed under the MIT License. See the LICENSE file for more information.


๐Ÿ‘ฅ Contributors

This project is actively maintained by Yash Bansal under the OpenSeek AI organization. Feel free to reach out for collaborations!


โญ Star the Repo

If you find this project useful, helpful, or interesting, please consider leaving a star โญ on the repository! It helps the project grow and reach more people.

Built with โค๏ธ to keep the internet transparent.