Skip to content

scriptbyayush/ScamShield

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“± CallSy / v1.0

CallSy is an AI-powered Android scam call detection app that protects users from fraudulent phone calls by analyzing speech, detecting scam-related keywords, and providing real-time alerts β€” all with a strong focus on privacy and explainability.


✨ Key Features

  • βœ… Real-Time Scam Call Detection
  • βœ… Speech-to-Text using OpenAI Whisper (locally or via API)
  • βœ… Scam Keyword & Sentiment Analysis via LLaMA 3.2 NLP
  • βœ… Highlights Risky Phrases (e.g., "OTP", "CVV", "bank")
  • βœ… Explainable AI Output with Confidence Score
  • βœ… Automatic Post-Call Analysis & Flagging
  • βœ… Secure, Offline & Self-hosted Backend Integration
  • βœ… Scam History Dashboard & Call Block Option
  • βœ… Multi-language & Lightweight Android Support

πŸ› οΈ Tech Stack

  • Frontend: Android
  • AI Tools: OpenAI Whisper (Speech-to-Text), LLaMA 3.2 (NLP), Sentiment Analysis
  • Backend: Flask

πŸ“± Installation (For Users)

  1. Clone the repo or download the APK.
  2. Allow permissions (Microphone, Storage, Caller ID).
  3. App automatically runs in background and analyzes call after completion.
  4. View alerts in dashboard.

βš™οΈ Developer Setup

Clone the project:

git clone https://github.com/scriptbyayush/ScamShield.git
cd ScamShield

Android Studio:

  • Open the project in Android Studio.
  • Sync Gradle.
  • Update API keys and endpoint in Constants.kt.
  • Connect your device/emulator and run the app.

πŸ§ͺ Sample Flow

// After call ends
String audioPath = AudioRecorder.getLastCallAudio();
String transcript = WhisperTranscriber.transcribe(audioPath);
ScamResult result = NLPAnalyzer.analyze(transcript);

if(result.isScam()) {
    AlertManager.showScamWarning(result);
}

πŸ“· Screenshots

Sample Output

πŸ“¦ Backend Setup

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run server
python app.py

🧠 AI Models Used

  • OpenAI Whisper – Speech to Text
  • LLaMA 3.2 NLP – Contextual Language Understanding
  • Custom Sentiment Analyzer – Detect tone and emotional manipulation
  • Keyword Pattern Engine – Detects sensitive terms (e.g., OTP, PAN, CVV)

πŸ” Privacy & Ethics

  • No third-party server calls unless explicitly configured
  • Local device processing available for Whisper + NLP
  • User consent taken for microphone access
  • Transparent scam detection logic

πŸš€ Coming Soon

  • πŸ”’ OTP Interception Protection
  • 🌐 Cloud Sync for History (Encrypted)
  • 🧠 Continuous Learning from User Feedback

πŸ“¬ Contact


About

πŸ“± CallSy is an AI-powered Android app that detects scam calls in real-time using speech analysis (Whisper + LLaMA 3.2) with privacy-first, explainable AI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages