Skip to content

Abd-Abdullah83/NeuralEye

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

59 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation


πŸ–₯️ Platform Preview

╔══════════════════════════════════════════════════════════════════════╗
β•‘   NeuralEye v4.0 β”‚ AI Detection Platform                  πŸŒ™ Dark  β•‘
╠══════════════════╦═══════════════════════════════════════════════════╣
β•‘  🏠 Home         β•‘                                                   β•‘
β•‘  πŸ” Image Check  β•‘   ╔════════════════════════════════════════╗     β•‘
β•‘  πŸ–ΌοΈ Batch Check  β•‘   β•‘  🚨  DEEPFAKE / AI-GENERATED          β•‘     β•‘
β•‘  🎬 Video Detect β•‘   β•‘  Combined Score: 94%                   β•‘     β•‘
β•‘  πŸŽ™οΈ Audio Detect β•‘   β•‘  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘  CRITICAL   β•‘     β•‘
β•‘  πŸ“° News Check   β•‘   β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•     β•‘
β•‘  πŸ’¬ Ask AI       β•‘                                                   β•‘
β•‘  ──────────────  β•‘   Gemini       β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ  91%                 β•‘
β•‘  πŸŽ“ Learn        β•‘   HuggingFace  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ    96%                 β•‘
β•‘  πŸ• Timeline     β•‘   Sightengine  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ     94%                 β•‘
β•‘  🀝 Pledge       β•‘   Audio Clone  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ   89%  πŸŽ™οΈ NEW        β•‘
β•‘  βš™οΈ Settings     β•‘   Batch Check  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ  [5/5 imgs] πŸ–ΌοΈ NEW  β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•©β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

⚑ What is NeuralEye?

NeuralEye is a free, fully client-side AI detection platform built for Pakistan's digital safety. Now with 5 detection modes β€” it detects AI-generated images, deepfake videos, cloned voices, and fake news using multiple AI engines simultaneously, all in your browser with zero backend.

"AI can now clone a voice in 3 seconds. Deepfakes swayed Pakistan's 2024 elections. 50M+ WhatsApp users forward without checking. NeuralEye was built to change that β€” free, forever."


πŸ†• What's New in v4.0

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  NEW in v4.0 β€” Biggest update yet                                   β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  πŸ–ΌοΈ  Batch Image Check  β€” Analyze up to 5 images simultaneously    β”‚
β”‚  πŸŽ™οΈ  Audio Deepfake Detector  β€” Detect AI voice clones             β”‚
β”‚  ⚑  3 APIs per batch image  β€” Gemini + HuggingFace + Sightengine  β”‚
β”‚  πŸ›‘οΈ  FIA Cybercrime button  β€” Report high-threat content directly  β”‚
β”‚  πŸ“Š  Enhanced confidence display  β€” Per-model breakdown in batch    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ† Features at a Glance

Feature Description Status
πŸ–ΌοΈ Image Analyzer Upload any image β€” 3 AI engines classify it as Real, AI-Generated, or Deepfake βœ… Live
πŸ“¦ Batch Check Upload up to 5 images at once β€” all 3 APIs run per image, summary + export βœ… NEW
🎬 Video Detector Extract 8 frames + full temporal analysis via 4 AI models βœ… Live
πŸŽ™οΈ Audio Detector Upload voice clips β€” detect AI clones, synthetic voices & manipulated audio βœ… NEW
πŸ“° News Checker Verify headlines, articles, or screenshots against trusted sources βœ… Live
πŸ’¬ Ask AI Multi-turn chat with Gemini β€” education, health, career, Pakistan topics βœ… Live
πŸ“Š Confidence Chart Visual bar chart of every AI engine's score per analysis βœ… Live
πŸ”΄ Threat Meter 0–100% danger level if fake content is shared publicly βœ… Live
πŸ›‘οΈ FIA Report Button Direct link to Pakistan's Cybercrime Wing for high-threat cases βœ… NEW
πŸ“„ PDF Export Full forensics report download in one click β€” all detection modes βœ… Live
πŸ“± WhatsApp Share One-tap share of detection result for public awareness βœ… Live
πŸ”Š Voice I/O Speak your question, hear results read aloud βœ… Live
πŸŒ™ Dark / Light Mode Full theme support with custom accent colors βœ… Live
πŸ‡΅πŸ‡° Urdu Support Full RTL Urdu translation across the sidebar and UI βœ… Live
🀝 Digital Pledge Community commitment to verify-before-sharing βœ… Live

🧠 Detection Engines

πŸ–ΌοΈ Image & Batch Detection

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚           YOUR IMAGE (Single or up to 5 in Batch)           β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β–Ό            β–Ό            β–Ό
  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚  GEMINI 2.5  β”‚ β”‚HUGGING   β”‚ β”‚  SIGHTENGINE    β”‚
  β”‚  Flash Lite  β”‚ β”‚  FACE    β”‚ β”‚  GenAI Model    β”‚
  β”‚              β”‚ β”‚sdxl-det. β”‚ β”‚                 β”‚
  β”‚ Visual reaso-β”‚ β”‚Binary    β”‚ β”‚ AI probability  β”‚
  β”‚ ning + clues β”‚ β”‚classify  β”‚ β”‚ scoring API     β”‚
  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
         β”‚              β”‚               β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                        β–Ό
             β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
             β”‚  WEIGHTED AVERAGE  β”‚
             β”‚  COMBINED VERDICT  β”‚
             β”‚  + Threat Level    β”‚
             β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🎬 Video Analysis Pipeline

Video File
    β”‚
    β”œβ”€ Step 1 ──► Extract 8 key frames (browser-side canvas)
    β”œβ”€ Step 2 ──► HuggingFace #1: dima806/deepfake_vs_real (per frame)
    β”œβ”€ Step 3 ──► HuggingFace #2: Wvolf/ViT-Deepfake-Detection (per frame)
    β”œβ”€ Step 4 ──► Gemini 1.5 Flash: Temporal artifacts + facial analysis
    β”œβ”€ Step 5 ──► Sightengine: Dedicated deepfake + GenAI video model
    └─ Step 6 ──► Weighted combined score β†’ FINAL VERDICT

πŸŽ™οΈ Audio Deepfake Pipeline (New)

Audio File (MP3 / WAV / OGG / M4A)
    β”‚
    β”œβ”€ Step 1 ──► HuggingFace: mo-zada/deepfake-audio-detection
    β”‚             └─ Binary classify: REAL vs FAKE voice
    β”œβ”€ Step 2 ──► Gemini 2.5 Flash Lite: Spectral + pattern analysis
    β”‚             └─ Detects: unnatural rhythm, missing breath sounds,
    β”‚                         robotic enunciation, processing artifacts
    └─ Step 3 ──► Weighted combined verdict β†’ CLONED / SUSPICIOUS / REAL

πŸ“¦ Batch Check Pipeline (New)

Up to 5 Images
    β”‚
    β”œβ”€ Per image: Gemini + HuggingFace + Sightengine run in parallel
    β”œβ”€ Combined score computed per image
    β”œβ”€ Summary dashboard: Real / AI-Generated / Deepfake counts
    └─ Export: PDF report  Β·  Share card  Β·  WhatsApp  Β·  Copy

πŸ› οΈ Tech Stack

Layer Technology
πŸ—οΈ Frontend Vanilla HTML5 + CSS3 + JavaScript (ES2022) β€” zero frameworks
πŸ€– Image AI 1 Google Gemini 2.5 Flash Lite (visual reasoning + clue extraction)
πŸ€— Image AI 2 HuggingFace β€” Organika/sdxl-detector (binary classification)
πŸ‘οΈ Image AI 3 Sightengine GenAI Model (probability scoring)
🎬 Video AI 1 HuggingFace β€” dima806/deepfake_vs_real_image_detection
🎬 Video AI 2 HuggingFace β€” Wvolf/ViT-Deepfake-Detection
🎬 Video AI 3 Google Gemini 1.5 Flash (temporal + facial analysis)
🎬 Video AI 4 Sightengine Deepfake + GenAI video model
πŸŽ™οΈ Audio AI 1 HuggingFace β€” mo-zada/deepfake-audio-detection
πŸŽ™οΈ Audio AI 2 Google Gemini 2.5 Flash Lite (spectral reasoning)
πŸ“Š Charts Chart.js 4.4.0
πŸ“„ PDF jsPDF 2.5.1 + html2canvas 1.4.1
πŸ—ƒοΈ Storage Browser localStorage (zero backend)
🌐 Hosting GitHub Pages
πŸ”‘ Fonts Space Mono + DM Sans + Noto Nastaliq Urdu

πŸš€ Getting Started

Option A β€” Use it Instantly (No Setup)

πŸ‘‰ Open NeuralEye Live β€” works in any modern browser.

Option B β€” Run Locally

# 1. Clone the repository
git clone https://github.com/Abd-Abdullah83/NeuralEye.git

# 2. Open the file (no server needed)
cd NeuralEye
open index.html

Option C β€” Fork & Deploy to GitHub Pages

# 1. Fork this repo on GitHub
# 2. Go to Settings β†’ Pages β†’ Source: main branch / root
# 3. Live at: https://YOUR-USERNAME.github.io/NeuralEye/

πŸ”‘ API Keys Setup

NeuralEye requires free API keys from 3 providers. Keys are stored only in your browser.

API Used For Free Tier Get Key
Google Gemini Image, Video, Audio, News, Ask AI βœ… 1M tokens/day ai.google.dev
HuggingFace Image, Video, Audio classifiers βœ… Free inference huggingface.co/settings/tokens
Sightengine Image + Video GenAI scoring βœ… 500 ops/month sightengine.com
NewsAPI (optional) News cross-reference βœ… 100 req/day newsapi.org
JSONBin (optional) Pledge counter sync βœ… Free jsonbin.io

Open NeuralEye β†’ βš™οΈ Settings & APIs β†’ paste keys β†’ πŸ’Ύ Save Keys


πŸ“Έ Core Tabs Explained

πŸ” Image Analyzer

Upload via drag & drop, file browser, or image URL. All 3 engines (Gemini, HuggingFace, Sightengine) run in parallel. Results include combined verdict, threat level, visual clues, Gemini explanation, and confidence chart. Includes a "guess before AI" quiz, PDF export, share card, and WhatsApp sharing. High-threat images show a direct FIA Cybercrime (nr3c.gov.pk) report button.

πŸ“¦ Batch Image Check ✨ New

Upload up to 5 images at once β€” ideal for checking WhatsApp forwarded image groups. Each image is analyzed by all 3 APIs (Gemini + HuggingFace + Sightengine) with results displayed in a summary dashboard showing Real / AI-Generated / Deepfake counts. Supports PDF export, share card, WhatsApp share, and clipboard copy for the full batch.

🎬 Video Deepfake Detector

Supports MP4, WEBM, MOV up to 50MB. Extracts 8 key frames client-side. Runs 4 AI models β€” 2 HuggingFace frame classifiers, Gemini 1.5 Flash for temporal analysis, and Sightengine for full video scoring. Displays a frame-by-frame grid with individual fake scores. Exports full PDF and share cards.

πŸŽ™οΈ Audio Deepfake Detector ✨ New

Upload MP3, WAV, OGG, or M4A files (min 3 seconds). Two AI models analyze the audio: HuggingFace's mo-zada/deepfake-audio-detection for binary classification, and Gemini for spectral reasoning about unnatural rhythm, missing breath sounds, robotic enunciation, and processing artifacts. Returns a CLONED / SUSPICIOUS / REAL verdict with detected clues and a PDF export. Pakistan context: AI voice cloning has been used against public figures and in financial scams.

πŸ“° News Checker

Input: headline text, article URL, or screenshot. Voice input supported. Gemini cross-references with optional NewsAPI live headlines. Verdict: VERIFIED / UNVERIFIED / DISPUTED / MISINFORMATION. Links to trusted Pakistani and international sources (Dawn, Geo, BBC Urdu, Reuters, AP, Snopes).

πŸ’¬ Ask AI

Powered by Gemini 2.5 Flash Lite. Full multi-turn conversation (last 10 turns maintained). Topic chips: Education, Health, Science, Tech, Pakistan, Career, Math. Full Markdown rendering in chat bubbles. Read Aloud and Copy buttons on every response. Enter key to send.

πŸŽ“ Education Hub + πŸ• Timeline

Pakistan-specific context: Elections, WhatsApp crisis, PECA law, audio deepfakes. Key global and Pakistani deepfake incidents from 2017–2025. 6 practical digital safety tips including reverse image search, source verification, and how to spot AI hands and eyes.


πŸ‡΅πŸ‡° Why Pakistan?

πŸ“Š  50M+ WhatsApp users β€” one of Asia's highest
πŸ—³οΈ  Deepfakes used in 2024 General Election misinformation
πŸŽ™οΈ  AI-cloned politician voices used for political attacks
πŸ“ž  Voice-clone scams targeting families with fake "emergency" calls
βš–οΈ  PECA 2016 criminalizes digital defamation (up to 3 yrs)
πŸ“±  Most forwarded content shared with zero fact-checking
πŸ›‘οΈ  NeuralEye = free tool built for this exact reality

πŸ”’ Privacy

βœ…  No account required          βœ…  No data stored on any server
βœ…  Images/audio sent ONLY to    βœ…  All processing in your browser
    your own API keys            βœ…  API keys never leave your device
βœ…  No analytics or tracking     βœ…  Fully open source β€” MIT licensed

πŸ“ Repository Structure

NeuralEye/
β”œβ”€β”€ index.html      ← Entire application (single-file architecture)
β”œβ”€β”€ banner.svg      ← Animated README banner (self-hosted)
β”œβ”€β”€ logo.png        ← App icon / favicon
β”œβ”€β”€ thumbnail.png   ← OG social preview image
└── README.md       ← You are here

πŸ—ΊοΈ Roadmap

  • Image deepfake detection (3 engines)
  • Batch image check (up to 5 images, all 3 APIs)
  • Video deepfake detection (4 engines + frame grid)
  • Audio deepfake / voice clone detection
  • News verification with Gemini + NewsAPI
  • Ask AI chat (multi-turn, Markdown rendering)
  • Urdu language support (RTL)
  • PDF export for all detection modes
  • Voice I/O (input + readout)
  • FIA Cybercrime report button
  • Browser extension version
  • Urdu voice recognition
  • Live camera deepfake detection
  • Community misinformation database
  • Mobile app (PWA)

🀝 Contributing

git checkout -b feature/your-feature-name
git commit -m "Add: your feature description"
git push origin feature/your-feature-name
# Then open a Pull Request

Good first contributions: Urdu translations Β· Timeline entries Β· Education content Β· Accuracy testing Β· New HuggingFace model integrations


πŸ“œ License

MIT License β€” Free to use, modify, and distribute.
Attribution appreciated but not required.

πŸ‘€ Author

Abdullah Β· BS Data Science Β· FAST-NUCES Lahore

Fighting misinformation one API call at a time πŸ‡΅πŸ‡°


GitHub LinkedIn Portfolio



⭐ Star this repo if NeuralEye helped you detect something fake!


NeuralEye v4.0 Β Β·Β  MIT License Β Β·Β  Built in Pakistan πŸ‡΅πŸ‡°


"Verify before you share. Every click matters."

Releases

No releases published

Packages

 
 
 

Contributors