Spaces:
Sleeping
Sleeping
| title: ScamVerifierV6 | |
| emoji: 💻 | |
| colorFrom: red | |
| colorTo: blue | |
| sdk: gradio | |
| sdk_version: 5.42.0 | |
| app_file: app.py | |
| pinned: false | |
| license: mit | |
| short_description: Instantly detect and flag potential online scams | |
| # Scam-Verifier 🛡️ | |
| **Protect yourself from phishing, spam, and scam messages with AI-powered analysis.** | |
| This web app allows users to paste suspicious messages, emails, or URLs and get a **risk assessment**, **red flags**, **recommendations**, and a ready-to-use **report template**. | |
| The backend uses **LangChain + OpenAI GPT** for intelligent scam detection. | |
| --- | |
| ## Features | |
| * **AI-Powered Scam Detection** | |
| Detects phishing, fake job offers, lottery scams, investment fraud, and other malicious messages. | |
| * **Risk Scoring & Classification** | |
| * HIGH RISK | |
| * MEDIUM RISK | |
| * LOW RISK | |
| * SAFE | |
| * **Red Flags & Recommendations** | |
| Lists specific warning signs and actionable steps to stay safe. | |
| * **Report Template Generator** | |
| Auto-generates a professional report to submit to authorities or platforms. | |
| * **Example Messages** | |
| Test with preloaded phishing, fake job, investment, and lottery scam examples. | |
| * **Clean & Modern UI** | |
| Fully responsive, mobile-friendly, with smooth interactions and copy-to-clipboard support. | |
| --- | |
| ## How It Works | |
| 1. **User Input:** Paste a suspicious message or provide a URL. | |
| 2. **AI Analysis:** Backend uses GPT via LangChain to evaluate the message. | |
| 3. **Risk Assessment:** Generates a risk score (0–100) and classification. | |
| 4. **Red Flags & Recommendations:** Highlights suspicious elements and safety tips. | |
| 5. **Report Template:** Provides a ready-to-use scam report template. | |
| --- | |
| ## Installation | |
| > Note: Designed for deployment on **Hugging Face Spaces**, but can run locally with Flask. | |
| 1. Clone the repository: | |
| ```bash | |
| git clone <repo-url> | |
| cd scam-signal-verifier | |
| ``` | |
| 2. Create a virtual environment and activate: | |
| ```bash | |
| python -m venv venv | |
| source venv/bin/activate # Linux/Mac | |
| venv\Scripts\activate # Windows | |
| ``` | |
| 3. Install dependencies: | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 4. Set your **OpenAI API key**: | |
| ```bash | |
| export OPENAI_API_KEY="your_api_key" # Linux/Mac | |
| set OPENAI_API_KEY="your_api_key" # Windows | |
| ``` | |
| 5. Run the app: | |
| ```bash | |
| python app.py | |
| ``` | |
| 6. Open in browser: `http://localhost:7860` | |
| --- | |
| ## Usage | |
| 1. Paste your suspicious message in the text area. | |
| 2. Optionally, add a URL to check. | |
| 3. Click **Analyze for Scam Signals**. | |
| 4. View risk score, red flags, recommendations, and report template. | |
| 5. Use the **Copy Report Template** button to quickly save it. | |
| --- | |
| ## Deployment on Hugging Face Spaces | |
| 1. Create a new **Flask Space**. | |
| 2. Add `app.py`, `requirements.txt`, and `templates/index.html`. | |
| 3. Set your **OpenAI API key** as a secret in HF Spaces. | |
| 4. Deploy — the app is live automatically. | |
| --- | |
| ## Example Messages | |
| * **Phishing Email:** Fake account verification messages. | |
| * **Fake Job Offer:** Work-from-home scams requesting upfront fees. | |
| * **Investment Scam:** Unrealistic “double your money” offers. | |
| * **Lottery Scam:** Fake lottery winnings asking for bank details. | |
| --- | |
| ## Technologies Used | |
| * **Python 3.10+** | |
| * **Flask** – Backend web framework | |
| * **LangChain** – AI orchestration | |
| * **OpenAI GPT** – Scam detection model | |
| * **HTML/CSS/JS** – Frontend UI | |
| * **FontAwesome** – Icons | |
| --- | |
| ## Security Notes | |
| * All analysis happens server-side using **OpenAI GPT**. | |
| * No user data is stored permanently. | |
| * Always **verify critical messages independently**. | |
| * This tool is **advisory only**, not legally binding. | |
| --- | |
| ## License | |
| MIT License © 2025 | |
| --- | |
| Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference |