AayanSuleri/ScamVerifier

1---2license: mit3title: Scam Verifier4sdk: gradio5emoji: 💻6colorFrom: blue7colorTo: red8short_description: Verify wether the message is a scam or not9sdk_version: 5.42.010---11# 🛡️ Scam-Signal Verifier12 13A comprehensive web application that helps users identify potentially fraudulent messages, emails, and advertisements. Perfect for protecting students, elderly individuals, and anyone who wants to stay safe from online scams.14 15## 🌟 Features16 17### Multi-Agent Analysis System18- **Claim Extractor**: Parses messages for URLs, phone numbers, emails, and financial amounts19- **Pattern Verifier**: Analyzes content against known scam patterns and suspicious keywords20- **Risk Calculator**: Provides a comprehensive risk score (0-100) with clear classification21- **Human-Friendly Explainer**: Generates actionable recommendations and reporting templates22 23### Detection Capabilities24- **Phishing Emails**: Bank, PayPal, Amazon verification scams25- **Job Offer Scams**: Work-from-home and "easy money" schemes  26- **Investment Fraud**: Cryptocurrency and get-rich-quick schemes27- **Lottery/Prize Scams**: Fake winnings and inheritance claims28- **Urgency Tactics**: High-pressure language and artificial deadlines29- **Suspicious Domains**: Known malicious and shortened URLs30 31### User Experience32- Clean, modern interface with gradient design33- Real-time risk assessment with color-coded results34- Pre-loaded example scams for testing35- One-click report template generation36- Mobile-responsive design37 38## 🚀 Quick Start39 40### Local Development41```bash42# Clone the repository43git clone <repository-url>44cd scam-signal-verifier45 46# Install dependencies47pip install -r requirements.txt48 49# Run the application50python app.py51```52 53### Docker Deployment54```bash55# Build the image56docker build -t scam-verifier .57 58# Run the container59docker run -p 7860:7860 scam-verifier60```61 62### Hugging Face Spaces63This app is optimized for Hugging Face Spaces deployment:641. Upload all files to your Spaces repository652. Set the Space to use Python/Gradio environment663. The app will automatically start on port 786067 68## 🎯 How It Works69 70### 1. Message Analysis71The system extracts key information from suspicious messages:72- URLs and domain reputation73- Contact information (phone, email)74- Financial references and amounts75- Suspicious keywords and phrases76- Urgency indicators and pressure tactics77 78### 2. Risk Assessment79Multi-factor scoring algorithm considers:80- **Keyword Score** (0-40 points): Suspicious language patterns81- **Urgency Score** (0-25 points): High-pressure tactics82- **Domain Risk** (0-20 points): Suspicious or shortened URLs83- **Contact Risk** (0-10 points): Multiple contact methods84- **Financial Risk** (0-15 points): Money-related content85 86### 3. Classification System87- **🔴 HIGH RISK (80-100)**: Obvious scam, avoid completely88- **🟡 MEDIUM RISK (50-79)**: Suspicious, verify independently  89- **🟢 LOW RISK (25-49)**: Minor concerns, stay cautious90- **✅ MINIMAL RISK (0-24)**: Appears legitimate91 92## 📊 Example Results93 94### High-Risk Phishing Email95```96Risk Score: 95/100 - HIGH RISK97Red Flags:98🚨 Contains 6 suspicious keywords/phrases99🚨 Uses high-pressure urgency tactics  100🚨 Uses suspicious domain: secure-bank-verify.net101🚨 Mentions money/financial transactions102 103Recommendations:104🚫 Do NOT click any links or provide personal information105📧 Report this message as spam/phishing106🛡️ Block the sender immediately107```108 109## 🛡️ Safety Features110 111- **No External API Calls**: All analysis happens locally for privacy112- **Educational Focus**: Teaches users to recognize scam patterns113- **Report Generation**: Creates templates for reporting to authorities114- **Multiple Examples**: Pre-loaded scenarios for learning115 116## 🔧 Technical Stack117 118- **Backend**: Python Flask with modular analysis engine119- **Frontend**: Responsive HTML/CSS/JavaScript120- **Deployment**: Docker + Gunicorn for production121- **Security**: No data persistence, privacy-focused design122 123## 📱 Mobile Support124 125The interface is fully responsive and works seamlessly on:126- Desktop browsers127- Mobile phones128- Tablets129- Touch devices130 131## 🤝 Contributing132 133This is an educational tool designed to help people stay safe online. Feel free to:134- Report bugs or issues135- Suggest new scam patterns to detect136- Improve the UI/UX design137- Add new analysis features138 139## 📄 License140 141Open source educational project. Use responsibly to help others stay safe from online scams.142 143## ⚠️ Disclaimer144 145This tool is for educational purposes and general guidance. It should not be the sole method for determining if something is a scam. Always use your best judgment and consult with relevant authorities when needed.146 147---148 149**Stay Safe Online! 🛡️**