Skip to content

ByteQuest-2025/GFGBQ-Team-syndicate-members

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

26 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ ScamShield - AI-Powered Real-Time Fraud Detection

Status Version License Platform Languages ML Accuracy

1๏ธโƒฃ Problem Statement

PS 11: Real-Time Audio Fraud Detection for Scam Prevention

With the rapid rise of voice-based scams, fraudsters increasingly exploit phone calls to deceive users. Particularly vulnerable groups such as elderly individuals, digitally unaware users, and first-time internet adopters. These scams often involve impersonation, emotional manipulation, urgency tactics, and psychological pressure, making them difficult to detect in real time.

Traditional fraud detection systems primarily focus on post-transaction analysis or text-based signals, offering little to no protection during live phone conversations, where most financial and emotional damage occurs.

There is a critical need for an AI-powered, real-time audio intelligence system that can detect scam patterns as a call is happening and proactively protect users before fraud occurs.

Objective

Develop an innovative AI-driven solution that leverages real-time audio analysis and fraud detection to:

  • Identify scam or fraudulent phone calls as they occur
  • Protect users, especially elderly and vulnerable populations from financial and emotional harm
  • Provide timely alerts, guidance, or interventions during suspicious calls

2๏ธโƒฃ Project Name

ScamShield - AI-Powered Real-Time Fraud Detection

3๏ธโƒฃ Team Name

Team Syndicate Members

4๏ธโƒฃ Deployed Link

๐ŸŒ Live Application: https://ai-fraud-detection-msv.netlify.app/

5๏ธโƒฃ 2-Minute Demonstration Video Link

๐ŸŽฅ Demo Video: https://drive.google.com/drive/folders/1kiyIS_JOgh2pPR_Ot4XRnKb7wZ2DBTZE?usp=sharing

6๏ธโƒฃ PPT Link

๐Ÿ“Š Presentation: https://in.docworkspace.com/d/sICjeusrJArK26MoG?sa=601.1037

๐Ÿš€ Overview

ScamShield is an advanced AI-powered system that provides real-time protection against fraud calls. Using sophisticated speech recognition, natural language processing, and machine learning, it helps protect vulnerable users (especially elderly) from financial scams across 8 Indian languages.

โœจ Key Features

  • ๐ŸŽค Real-time Speech Recognition - Browser-based speech-to-text conversion
  • ๐Ÿค– AI-Powered ML Analysis - Advanced ensemble model with 75%+ accuracy
  • ๐ŸŒ 8-Language Support - English, Hindi, Telugu, Tamil, Kannada, Malayalam, Marathi, Bengali
  • ๐Ÿ“ฑ Elderly-Friendly UI - Large text, clear colors, simple messaging
  • โšก Instant Alerts - Immediate warnings for high-risk calls
  • ๐Ÿ“Š Comprehensive Training - 487 real-world fraud patterns
  • ๐Ÿ•’ Real-time Analysis - Live fraud probability scoring
  • ๐Ÿ”’ Privacy First - No personal data storage, local processing

๐Ÿ—๏ธ Architecture

Audio Input โ†’ Speech-to-Text โ†’ ML Processing โ†’ Risk Analysis โ†’ Alert Generation

Technology Stack

Frontend:

  • React.js with modern JavaScript
  • Web Speech API for real-time transcription
  • Responsive design with CSS3 animations
  • Multi-language UI support

Backend:

  • Node.js with Express.js
  • Python ML integration
  • RESTful API architecture
  • Real-time fraud detection pipeline

Machine Learning:

  • Advanced ensemble model (LogisticRegression + SVM + NaiveBayes + GradientBoosting)
  • TF-IDF vectorization with 5000 features
  • 4-gram analysis for pattern detection
  • 487 comprehensive training samples

๐Ÿค– ML Model Performance

Metric Value
Overall Accuracy 75.4%
Training Samples 487
Fraud Samples 225
Legitimate Samples 262
Features 5000 TF-IDF
N-gram Range (1, 4)

Language-Specific Performance

  • Malayalam: 91.7% fraud detection
  • Marathi: 93.9% fraud detection
  • Bengali: 90.8% fraud detection
  • Telugu: 91.0% fraud detection
  • All Languages: 90%+ critical fraud detection

๐ŸŒ Multi-Language Support

Language Script Code Status
English Latin en-US โœ… Active
Hindi Devanagari hi-IN โœ… Active
Telugu Telugu te-IN โœ… Active
Tamil Tamil ta-IN โœ… Active
Kannada Kannada kn-IN โœ… Active
Malayalam Malayalam ml-IN โœ… Active
Marathi Devanagari mr-IN โœ… Active
Bengali Bengali bn-IN โœ… Active

๐Ÿš€ Quick Start

Prerequisites

  • Node.js (v14 or higher)
  • Python 3.7+ with pip
  • Modern web browser with microphone access
  • Internet connection for API calls

Installation

  1. Clone the repository

    git clone https://github.com/ByteQuest-2025/GFGBQ-Team-syndicate-members.git
    cd GFGBQ-Team-syndicate-members/fraud-audio-detection
  2. Backend Setup

    cd backend
    npm install
    pip install -r requirements.txt
    python ml_fraud_detector.py train  # Train ML model
    npm start

    Server runs on http://localhost:5000

  3. Frontend Setup

    cd frontend
    npm install
    npm start

    App runs on http://localhost:3000

๐ŸŽฏ Usage

  1. Start Protection - Click "Start Protection" to begin monitoring
  2. Grant Permissions - Allow microphone access when prompted
  3. Select Language - Choose your preferred language from dropdown
  4. Real-time Analysis - System analyzes speech in real-time
  5. Instant Alerts - Receive immediate warnings for suspicious calls
  6. Stay Safe - Follow the system's recommendations

๐Ÿ” API Documentation

Analyze Text

POST /api/analyze-text
Content-Type: application/json

{
  "transcript": "Your bank account has been blocked share OTP immediately"
}

Response:

{
  "riskLevel": "Critical",
  "scamPercentage": 91,
  "confidence": 0.91,
  "message": "๐Ÿšจ CRITICAL SCAM ALERT: Extremely high fraud probability detected!",
  "mlPrediction": {
    "isFraud": true,
    "fraudProbability": 0.91,
    "riskLevel": "Critical"
  },
  "detectedLanguage": "en",
  "languageName": "English",
  "analysisMethod": "ML-Powered Detection"
}

Train Model

POST /api/train-model

Get Supported Languages

GET /api/languages

Emergency Alert

POST /api/emergency-alert
Content-Type: application/json

{
  "phoneNumber": "+91-9876543210",
  "transcript": "Scam call transcript",
  "userLocation": "Mumbai, India"
}

๐Ÿ›ก๏ธ Security Features

  • Advanced ML Detection - Ensemble model with multiple algorithms
  • Multi-language Analysis - Unicode-aware text processing
  • Real-world Patterns - 487 actual fraud techniques
  • Privacy First - No personal data storage
  • Local Processing - Speech recognition in browser
  • Emergency Alerts - Automatic threat logging

๐Ÿ“Š Fraud Detection Categories

Category Examples Risk Level
Banking Scams "Account blocked", "Share OTP" Critical
Government Threats "Police case", "Arrest warrant" Critical
Prize Scams "Lottery winner", "Processing fee" High
Tech Support "Computer virus", "Remote access" High
Delivery Scams "Parcel held", "Customs fee" Medium

๐ŸŽจ UI/UX Highlights

  • Modern Design - Gradient backgrounds and smooth animations
  • Accessibility - Large fonts and high contrast for elderly users
  • Visual Feedback - Color-coded risk levels (Red/Yellow/Green)
  • Responsive - Works on desktop and mobile devices
  • Multi-language UI - Native language support
  • Intuitive - Simple interface with clear instructions

๐Ÿ“ Project Structure

fraud-audio-detection/
โ”œโ”€โ”€ frontend/
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ App.js          # Main React component
โ”‚   โ”‚   โ””โ”€โ”€ index.js        # Entry point
โ”‚   โ”œโ”€โ”€ package.json        # Frontend dependencies
โ”‚   โ””โ”€โ”€ package-lock.json
โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ server.js           # Node.js server
โ”‚   โ”œโ”€โ”€ ml_fraud_detector.py # Python ML model
โ”‚   โ”œโ”€โ”€ requirements.txt    # Python dependencies
โ”‚   โ”œโ”€โ”€ package.json        # Backend dependencies
โ”‚   โ”œโ”€โ”€ setup.bat          # Windows setup script
โ”‚   โ””โ”€โ”€ ML_TEST_RESULTS.md # ML performance results
โ”œโ”€โ”€ .gitignore             # Git ignore rules
โ””โ”€โ”€ README.md              # This file

๐Ÿ”ฎ Future Roadmap

  • Mobile app development (Android/iOS)
  • Voice pattern analysis integration
  • Government database integration
  • Community reporting features
  • Smart home integration
  • Advanced ML models (BERT, Transformers)
  • Real-time collaboration features
  • Blockchain-based fraud reporting

๐Ÿค Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“ธ Live Application Screenshots

๐Ÿ  Main Dashboard

ScamShield Main Interface

Clean, elderly-friendly interface with intuitive controls

๐ŸŒ Multi-Language Support

Language Selection

8 Indian languages with native script support

๐ŸŽค Real-Time Speech Processing

Speech Recognition

Live speech-to-text with instant fraud analysis

๐Ÿšจ Fraud Detection System

Critical Alert
Critical Risk Alert
High Risk
High Risk Warning
Medium Risk
Medium Risk Caution
Live Testing
Live Test Results

๐Ÿค– ML Model Training & Performance

ML Training Results

ML model training with 487 samples achieving 75.4% accuracy

Training Metrics

Comprehensive performance metrics and validation results

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ† Team Syndicate Members

ByteQuest 2025 - GeeksforGeeks Hackathon

  • Advanced ML implementation with ensemble models
  • Multi-language fraud detection system
  • Real-time speech processing
  • Production-ready deployment

๐Ÿ™ Acknowledgments

  • Web Speech API for real-time transcription
  • scikit-learn for machine learning capabilities
  • React.js community for excellent documentation
  • Fraud research organizations for pattern data
  • Beta testers and elderly user feedback
  • GeeksforGeeks for hosting ByteQuest 2025

๐Ÿ“ž Support

For support, create an issue in this repository or contact the development team.


๐Ÿ† ByteQuest 2025 - GeeksforGeeks Hackathon

๐Ÿ›ก๏ธ Protecting millions from fraud, one call at a time

Built with โค๏ธ by Team Syndicate Members
Hackathon Team

About

Repository for syndicate members - Vibe Coding Hackathon

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors