Skip to content

Uchiha-byte/TruthScan

Repository files navigation

πŸ” TruthScan - Defending Digital Truth Through Intelligent Content Verification Platform

A comprehensive AI-powered platform for detecting and analyzing synthetic content across multiple media types with a cyberpunk-themed interface and real-time intelligence capabilities.

✨ Features

🎯 Core Detection Capabilities

  • Text Analysis: Linguistic pattern detection, GPT fingerprinting, semantic verification
  • Image Forensics: Deepfake detection, pixel-level analysis, GAN artifact identification
  • Audio Verification: Voice cloning detection, spectral analysis, waveform authentication
  • Video Analysis: Temporal consistency checking, face-swap detection, motion vector analysis

πŸ–₯️ User Interface

  • Cyberpunk Theme: Futuristic design with neon effects and animations
  • Responsive Design: Works across desktop and mobile devices
  • Real-time Updates: Live data streaming and dynamic content
  • Interactive Dashboards: Comprehensive analytics and reporting

🧠 Intelligence Features

  • Threat Intelligence: Global threat monitoring and geospatial analysis
  • Real-time Analytics: Live detection statistics and performance metrics
  • Source Verification: Content authentication and verification
  • Comprehensive Reporting: Detailed analysis reports and export options

πŸš€ Quick Start

Prerequisites

  • Python 3.7 or higher
  • pip package manager

Installation

  1. Clone or download the project

    git clone <https://github.com/Uchiha-byte/TruthScan.git>
    cd TruthScan
  2. Install dependencies

    pip install -r requirements.txt
  3. Start the application

    python start.py
  4. Access the platform

πŸ“ Project Structure

TruthScan/
β”œβ”€β”€ backend.py              # Flask backend server
β”œβ”€β”€ index.html              # Main landing page
β”œβ”€β”€ start.py                # Application startup script
β”œβ”€β”€ requirements.txt        # Python dependencies
β”œβ”€β”€ README.md              # This file
β”œβ”€β”€ CODEBASE_INDEX.md      # Detailed codebase documentation
└── templates/             # Flask templates
    β”œβ”€β”€ base.html          # Base template with shared styling
    β”œβ”€β”€ dashboard.html     # Dashboard page
    β”œβ”€β”€ detection.html     # Content detection interface
    β”œβ”€β”€ intelligence.html  # Threat intelligence dashboard
    └── reports.html       # Analytics and reports

πŸ› οΈ Technology Stack

Backend

  • Flask: Web application framework
  • Flask-CORS: Cross-origin resource sharing
  • Pillow: Image processing library
  • Python 3.7+: Programming language

Frontend

  • HTML5: Semantic structure
  • CSS3: Advanced styling with animations
  • Tailwind CSS: Utility-first CSS framework
  • JavaScript: Interactive functionality
  • Google Fonts: Typography (Orbitron, Exo 2)

Design System

  • Color Palette: Cyberpunk theme (cyan, purple, pink)
  • Typography: Orbitron (headings), Exo 2 (body)
  • Animations: CSS keyframes and transitions
  • Effects: Neon glows, holographic cards, particle systems

πŸ”§ API Endpoints

Content Analysis

  • POST /api/analyze - Analyze uploaded content
  • GET /api/threats - Get threat intelligence data
  • GET /api/dashboard - Get dashboard statistics
  • GET /api/intelligence - Get intelligence data
  • GET /api/reports - Get reports and analytics

Page Routes

  • / - Main landing page
  • /dashboard - Command dashboard
  • /detection - Neural detection chamber
  • /intelligence - Global threat matrix
  • /reports - Analytics and reports

🎨 Interface Components

Main Landing Page

  • Hero section with animated title
  • Content type selection cards
  • Analysis panel with real-time results
  • Global threat intelligence overview

Dashboard

  • System status monitoring
  • Recent detection activity
  • Threat distribution charts
  • Performance metrics

Detection Chamber

  • Multi-modal content analysis
  • Real-time forensic results
  • Model status monitoring
  • Interactive analysis tools

Intelligence Matrix

  • Geospatial threat mapping
  • Real-time threat feed
  • Source analysis and verification
  • Temporal activity tracking

Reports & Analytics

  • Daily/weekly trend analysis
  • Performance metrics
  • Detection accuracy by type
  • Export options (PDF, CSV, API)

πŸ” Detection Models

Text Analysis (v3.2)

  • Perplexity analysis
  • Burstiness detection
  • Semantic coherence checking
  • GPT fingerprinting

Image Forensics (v2.8)

  • GAN artifact detection
  • Noise pattern analysis
  • Compression artifact identification
  • Color space analysis

Audio Verification (v1.9)

  • Voice cloning detection
  • Spectral anomaly analysis
  • Temporal inconsistency detection
  • Acoustic fingerprinting

Video Analysis (v4.1)

  • Frame-level analysis
  • Motion vector analysis
  • Face swap detection
  • Temporal artifact identification

πŸ“Š Real-time Data

The platform includes realistic prototype data including:

  • 2,847 active threats globally
  • 156 deepfakes detected
  • 98.7% accuracy rate
  • 45,000 verified sources
  • Real-time threat intelligence feeds
  • Geospatial threat clustering
  • Performance metrics and analytics

πŸš€ Getting Started

  1. Run the startup script

    python start.py
  2. The script will automatically:

    • Install required dependencies
    • Start the Flask backend server
    • Open your browser to the platform
  3. Navigate through the interface:

    • Use the navigation bar to access different sections
    • Try the detection features with sample content
    • Explore the intelligence dashboards
    • View real-time analytics and reports

πŸ”§ Development

Running in Development Mode

python backend.py

Adding New Features

  1. Backend: Add new routes in backend.py
  2. Frontend: Create new templates in templates/
  3. Styling: Update CSS in templates/base.html
  4. API: Add new endpoints for data

Customizing the Theme

  • Colors: Modify CSS variables in base.html
  • Animations: Update keyframe definitions
  • Layout: Adjust Tailwind CSS classes
  • Effects: Customize particle and glow systems

πŸ“ˆ Performance

  • Processing Time: 0.5-2.0 seconds per scan
  • System Uptime: 99.9%
  • API Response: <100ms average
  • Concurrent Users: Supports multiple simultaneous analyses

πŸ”’ Security Features

  • Content fingerprinting with SHA256 hashing
  • Content verification and authentication
  • Source validation and tracking
  • Threat intelligence integration
  • Real-time monitoring and alerting

πŸ“ License

This project is a prototype demonstration of Defending Digital Truth Through Intelligent Content Verification capabilities. All code and designs are for educational and demonstration purposes.


TruthScan - Advanced AI-powered Defending Digital Truth Through Intelligent Content Verification and verification platform.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors