README.md

metadata

title: DeceptivePatternDetector
emoji: 🐨
colorFrom: purple
colorTo: red
sdk: gradio
sdk_version: 5.46.0
app_file: app.py
pinned: false
license: cc-by-nc-4.0

🔍 Deceptive Pattern Detector

An AI-powered tool that analyzes website screenshots to detect potentially deceptive design patterns (also known as "dark patterns").

🚀 Features

• Image Upload: Upload screenshots of websites for analysis
• OCR Analysis: Extracts text and UI elements from images
• Element Detection: Identifies buttons, checkboxes, and other interactive elements
• AI Analysis: Uses Google Gemini AI to classify potential deceptive patterns
• Pattern Categories: Detects various types including:
  • Confirm-shaming
  • Urgency manipulation
  • Scarcity tactics
  • Misdirection
  • Privacy violations
  • And more...

📋 How to Use

1. Upload Image: Take a screenshot of a website and upload it
2. API Key: Enter your Google Gemini API key (Get one here)
3. Analyze: Click the analyze button and wait for results
4. Review: Examine the detected patterns and explanations

🔧 Requirements

• Google Gemini API key for AI analysis
• Google Cloud Vision API credentials (optional, for enhanced OCR)

🛠️ Technical Details

This tool combines:

• Computer Vision: For UI element detection
• OCR: For text extraction using Google Cloud Vision
• AI Analysis: Using Google Gemini for pattern classification
• Rule-based Fallbacks: For basic detection when AI is unavailable

⚠️ Disclaimer

This tool uses AI analysis and may not catch all deceptive patterns or may flag legitimate design elements. The results should be used as a supplementary guide and not as a definitive assessment.

🏗️ Architecture

• Frontend: Gradio interface
• Backend: Python with simplified computer vision
• AI: Google Gemini for pattern analysis
• Deployment: HuggingFace Spaces compatible

📄 License

MIT License - See LICENSE file for details.