https://github.com/nuraj250/traceback-reverse-image-finder
TraceBack helps you instantly find the source of any image, detect edits or crops, and identify AI-generated or fake images—all with one click.
https://github.com/nuraj250/traceback-reverse-image-finder
ai-image-detection computer-vision deep-learning flask image-recognition opencv perceptual-hashing react reverse-image-search
Last synced: 29 days ago
JSON representation
TraceBack helps you instantly find the source of any image, detect edits or crops, and identify AI-generated or fake images—all with one click.
- Host: GitHub
- URL: https://github.com/nuraj250/traceback-reverse-image-finder
- Owner: Nuraj250
- Created: 2025-03-23T04:21:15.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-04T16:29:09.000Z (6 months ago)
- Last Synced: 2025-12-08T00:44:00.229Z (6 months ago)
- Topics: ai-image-detection, computer-vision, deep-learning, flask, image-recognition, opencv, perceptual-hashing, react, reverse-image-search
- Language: JavaScript
- Homepage:
- Size: 900 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🕵️♂️ TraceBack – Reverse Image Finder
TraceBack is a full-stack web application built with **React** and **Flask** that allows you to:
- Upload an image via drag & drop or file picker
- Detect and compare it with existing images
- See visual similarity scores
- Analyze if it's AI-generated using DeepFace
- Export results to CSV or PDF
---
## 🚀 Features
- 🔍 Reverse image lookup using OpenCV feature matching (ORB)
- 🧬 Perceptual hashing for fast comparisons
- 🤖 AI image detection using DeepFace
- 📊 Visual similarity indicators
- 📁 Drag and drop upload
- 📤 Export results (CSV / PDF)
---
## 🖼️ Preview
### 🔼 Upload Image
### 📊 Matched Results
---
## 🧱 Tech Stack
| Frontend | Backend |
|----------|---------|
| React + Axios | Flask |
| HTML5 Drag-and-Drop | OpenCV (ORB) |
| FileSaver.js, jsPDF | DeepFace + Pillow + ImageHash |
---
## 🛠️ Installation
### 1. Clone the repo
```bash
git clone https://github.com/Nuraj250/traceback.git
cd traceback
```
---
### 2. Setup Backend (Flask)
```bash
cd backend
python -m venv venv
source venv/bin/activate # or venv\Scripts\activate on Windows
pip install -r requirements.txt
python app.py
```
> Flask runs on: `http://localhost:5000`
Make sure you have test images in `backend/static/database/`.
---
### 3. Setup Frontend (React)
```bash
cd ../frontend
npm install
npm start
```
> React runs on: `http://localhost:3000`
---
## 📂 Folder Structure
```
traceback/
├── backend/
│ ├── app.py
│ ├── static/uploads/
│ ├── static/database/
│ ├── utils/image_search.py
├── frontend/
│ ├── src/App.jsx
│ ├── src/components/ResultCard.jsx
│ ├── public/
│ └── docs/
│ ├── screenshot-upload.png
│ └── screenshot-results.png
├── README.md
```
---
## 📤 Exports
- 📄 Click “Export CSV” to download results in `.csv`
- 🧾 Click “Export PDF” for a clean printable report
---
## 💡 Future Ideas
- Image hosting (Cloudinary / S3)
- Save user history
- Real-time similarity percentage tuning
- Mobile UI optimization
---
## 📜 License
MIT © [Nuraj](https://github.com/Nuraj250)
```