Skip to content

AagmanS/TrapEyeXf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TrapEye β€” AI-Powered Cybersecurity Ecosystem

πŸ›‘οΈ Detect Phishing Β· Fake News Β· Deepfakes Β· Scams Β· Misinformation

Powered by Machine Learning + Google Gemini Multimodal AI

TrapEye Banner Python Next.js FastAPI Gemini

πŸ›‘οΈ TrapEye – AI Cyber Threat Detection Ecosystem

TrapEye is an AI-powered cybersecurity platform designed to protect users from modern digital threats such as:

  • Phishing links
  • Deepfake media
  • Fake news & misinformation
  • Job scams
  • Payment fraud
  • Credential breaches

The system combines machine learning, browser extensions, threat intelligence APIs, and community reporting to deliver real-time protection across web, messaging platforms, and browsers.


πŸš€ Live Demo

TrapEye is a full-stack AI cybersecurity ecosystem that uses a hybrid of traditional machine learning and Google Gemini multimodal AI to detect digital threats across multiple vectors β€” on the web, via browser extensions, WhatsApp, and a dedicated mobile app.

Module Purpose Tech
TrapEyeX Web Platform Full threat intelligence dashboard Next.js 14, FastAPI, Gemini AI
Chrome Extension (LinkLens) In-browser phishing link scanning Manifest V3, TrapEye API
WhatsApp Bot (LinkLens) Instant URL scanning via WhatsApp Twilio / WA API, Python
Sentinelix Mobile App Comprehensive mobile cybersecurity guardian React Native / Flutter

Applications Built During This Project

1. TrapEyeX β€” Web Platform

The flagship web dashboard featuring URL Scanner, Fake News Detector, Deepfake Analyzer, Threat Sandbox, and Live Intelligence Dashboard.

Full-stack Next.js + FastAPI application with Gemini AI integration.


2. Sentinelix & GuardMe β€” Mobile Cybersecurity Apps

An AI-powered mobile security guardian protecting users from phishing, scams, QR fraud, job scams, and credential breaches in real-time.

Splash & Onboarding

Sentinelix Splash Screen

Main Dashboard β€” Device Protection Score

Sentinelix Dashboard

QR Shield β€” AI Threat Interception for QR Codes

QR Shield

Credential Guard β€” Email Breach Checker

Credential Guard - Email Breach

Credential Guard β€” Password Leak Checker

Credential Guard - Password Leak

Threat Radar β€” Real-Time India Feed

Threat Radar

Job Shield β€” AI Recruitment Scam Analyzer

Job Shield

Guardian Setup β€” Family Emergency Alerts

Guardian Setup

QR Scam Scanner β€” Live Camera Mode

QR Scanner

All Tools Overview

All Tools


3. Chrome Extension (LinkLens)

A browser extension that scans any link in real-time as you hover or click, flagging phishing attempts directly in your browser.

Key Features:

  • One-click URL scanning via TrapEye API
  • Visual risk indicator (green/yellow/red)
  • Works on all websites in real-time
  • Manifest V3 compliant

4. LinkLens WhatsApp Bot

Send any suspicious URL to our WhatsApp bot and get an instant threat analysis report β€” no app download required.

Key Features:

  • Powered by Twilio/WhatsApp Business API
  • Returns risk level, phishing probability, and reasons
  • Ideal for non-tech-savvy users and senior citizens

TrapEyeX Web Platform β€” Module Details

URL Phishing Scanner

Extracts 20+ features including:

  • URL length, dot count, subdomain depth
  • IP address usage, HTTPS status
  • Domain entropy (randomness)
  • Suspicious TLD detection (.xyz, .tk, .ml)
  • Brand impersonation check
  • Phishing keyword detection

Fake News Detector

  • ML Layer: TF-IDF vectorization + Logistic Regression
  • Language Analysis: Sensationalism, clickbait, emotional language patterns
  • Source Credibility: Pre-scored database of 30+ news sources
  • Gemini Layer: Contextual reasoning and fact-check analysis

Deepfake Detector

  • Heuristic Analysis: JPEG quality, compression artifacts
  • Gemini Vision: Facial feature analysis, lighting consistency
  • Supports: JPEG, PNG, WebP, MP4, WebM (up to 50MB)

Threat Sandbox

  • Isolated virtual environment for threat payload analysis
  • Behavioral heuristics logging
  • Simulated C2 connection interception
  • Real-time containment status tracking

News Monitor & Dashboard

  • Fetches from NewsAPI across 6 categories
  • Auto-scores every article for credibility
  • Flags suspicious articles for alerts
  • Auto-refresh every 5 minutes
  • Live threat timeline and distribution charts ======= 🌐 Web Application

https://trapeye-demo.onrender.com/


Frontend (TrapEyeX Web)

  • Next.js 14 (App Router)
  • TailwindCSS (custom cybersecurity theme)
  • Framer Motion (page transitions + animations)
  • Recharts (threat charts)
  • Axios (API client)

Backend

  • FastAPI (Python)
  • SQLAlchemy + PostgreSQL
  • Scikit-learn (ML models β€” Random Forest, Logistic Regression, TF-IDF)
  • Google Gemini API (multimodal AI for reasoning + vision)
  • NewsAPI (real-time news feed)

Extensions & Bots

  • Chrome Extension: Manifest V3, Vanilla JS
  • WhatsApp Bot: Python, Twilio API / WhatsApp Business API

Project Structure

trapeyeX/
β”œβ”€β”€ backend/                  # FastAPI backend
β”‚   β”œβ”€β”€ main.py               # App entry point
β”‚   β”œβ”€β”€ config/               # Environment configuration
β”‚   β”œβ”€β”€ routes/               # API endpoints
β”‚   β”‚   β”œβ”€β”€ phishing.py
β”‚   β”‚   β”œβ”€β”€ fakenews.py
β”‚   β”‚   β”œβ”€β”€ deepfake.py
β”‚   β”‚   β”œβ”€β”€ news_monitor.py
β”‚   β”‚   └── dashboard.py
β”‚   β”œβ”€β”€ services/             # Business logic
β”‚   β”‚   β”œβ”€β”€ phishing_service.py
β”‚   β”‚   β”œβ”€β”€ fakenews_service.py
β”‚   β”‚   β”œβ”€β”€ deepfake_service.py
β”‚   β”‚   β”œβ”€β”€ news_service.py
β”‚   β”‚   └── gemini_service.py
β”‚   β”œβ”€β”€ models/               # DB models & schemas
β”‚   └── utils/                # Feature extractor, ML utils
β”œβ”€β”€ frontend/                 # Next.js 14 web app
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ page.tsx          # Landing page
β”‚   β”‚   β”œβ”€β”€ scanner/          # URL phishing scanner
β”‚   β”‚   β”œβ”€β”€ fakenews/         # News analyzer
β”‚   β”‚   β”œβ”€β”€ deepfake/         # Deepfake detector
β”‚   β”‚   β”œβ”€β”€ sandbox/          # Threat sandbox
β”‚   β”‚   └── dashboard/        # Threat intelligence dashboard
β”‚   └── components/           # Shared UI components
β”œβ”€β”€ chrome-extension/         # Browser extension (LinkLens)
β”œβ”€β”€ linklens-whatsapp/        # WhatsApp scanning bot
β”œβ”€β”€ ml_models/                # ML model training scripts
β”œβ”€β”€ grme/                     # App screenshots & media
β”œβ”€β”€ start.bat                 # One-click launcher (Windows)
└── README.md

Quick Start

Option 1: One-click (Windows)

start.bat

Option 2: Manual Setup

Prerequisites

  • Python 3.9+
  • Node.js 18+
  • PostgreSQL (optional β€” app works without DB using mock data)

Step 1: Train ML Models

cd ml_models
python generate_models.py

Step 2: Start Backend

cd backend
pip install -r requirements.txt
python -m uvicorn main:app --reload --port 8000

Step 3: Start Frontend

cd frontend
npm install
npm run dev

URLs

Getting API Keys

Gemini API

  1. Visit Google AI Studio
  2. Create an API key
  3. Add to backend/.env

News API

  1. Visit NewsAPI.org
  2. Sign up for a free key
  3. Add to backend/.env =======

=======

🧠 Core Modules

πŸ”— Link Intelligence

Detect phishing links using hybrid threat intelligence models.

Features:

  • Multi-source threat analysis
  • Domain reputation scoring
  • Malware/phishing detection
  • Sandbox link verification

Security Engines Used:

  • Safe Browsing
  • OpenPhish
  • IPQS
  • Domain heuristics

🎭 Deepfake Detection

Detect AI-generated manipulated media.

Capabilities:

  • Image authenticity checks
  • AI generated content detection
  • Pattern recognition using ML models

πŸ“° Fake News & Article Detector

Analyze suspicious articles using NLP based misinformation detection.

Features:

  • Content credibility scoring
  • Semantic analysis
  • Misinformation pattern detection

🧾 Credential Guard

Check whether emails or passwords appear in data breaches.

Capabilities:

  • Dark web breach detection
  • Password leak analysis
  • k-Anonymity based privacy protection

πŸ’° Payment Intercept

Protect users from UPI and QR code payment scams.

Features:

  • Fake UPI detection
  • Collect request identification
  • QR scam alerts
  • Fraud VPA detection

πŸ“· QR Shield

Scan QR codes and analyze embedded links.

Protection Against:

  • QR phishing attacks
  • Malicious download links
  • Payment redirection scams

πŸ’Ό Job Shield

Detect fake job offers and recruitment scams.

Capabilities:

  • LinkedIn job analysis
  • Scam pattern recognition
  • Employer verification
  • Risk scoring

🌐 Chrome Extension – Real Time Protection

TrapEye includes a browser extension that scans URLs automatically while browsing.

Features:

  • Real time phishing detection
  • Instant security alerts
  • Browser level threat monitoring
  • Safe browsing analysis

πŸ’¬ LinkLens Integration

LinkLens analyzes suspicious links shared via messaging platforms.

Capabilities:

  • WhatsApp link scanning
  • Fraud detection in forwarded messages
  • Reputation analysis

🀝 TrapEye Community Shield

A community powered cybersecurity intelligence system.

Users can:

  • Report suspicious links
  • Share new scam patterns
  • Build collective threat intelligence

About

AI-powered cybersecurity platform that detects phishing URLs, deepfakes, scams, and fraud in real time using machine learning, browser extensions, and threat intelligence.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors