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

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors