Tagline: A local, educational playground that uses AI roleplay to train people how to recognize and handle online scammers. 🎯🛡️
- LLM-powered scammer simulation — Gemini acts as the adversary from configurable templates.
- Scenario library — prebuilt scenarios (tech support, romance, invoice fraud, delivery spoof, fake refunds).
- Consent-first flow — built-in participant consent and logging prompts to ensure legal compliance.
- Detection training modules — checklists, red-flag indicators, live scoring.
- Report generation — exportable training reports for trainees and orgs.
Virtual Scam Baiter is built to train and protect real people. It lets learners safely interact with believable scam roleplays (romance scams, financial scams, unauthorized access pretexts, and more) so they can practice spotting red flags, crafting safe replies, and staying calm under pressure — all without exposing real personal data. 💪🔒
This tool is strictly educational: it helps users learn how social engineers manipulate emotions, urgency, and authority so those users can defend themselves in the wild. 🌐🧠
- Simulates scam conversations with different modes (Romance, Financial, Unauthorized access). 🎭
- Produces realistic scammer messages and suggested baiter replies that keep scammers engaged for training purposes. 🗣️🔁
- Logs sessions locally so learners can review how they responded and learn from mistakes. 📂🔎
- Enforces safety: the AI will refuse requests for real sensitive data and ask for fake placeholders for practice.
⚠️ ❌
git clone https://github.com/giriaryan694-a11y/virtual-scam-baiter.git
cd virtual-scam-baiter- Create a Python virtual environment
python3 -m venv venv
# Linux/macOS
source venv/bin/activate
# Windows (PowerShell)
# .\venv\Scripts\Activate.ps1- Install dependencies
pip install -U pip
pip install -r requirements.txt- Prepare your API key
open
key.txt
nano key.txt # in linux if you are using other os so use there any text editor- Paste your Gemini API key (single line) into
key.txt. - saved changes
- Run the GUI
python main.py- Enjoy
vist this site to see my documentary on scammers (last updated 23 Aug, 2025) : https://giriaryan694-a11y.github.io/virtual-scam-baiter/
This project exists to educate and defend. Do not use it to impersonate, defraud, or harass real people. Never paste or type real passwords, OTPs, bank details, or other sensitive personal data into the app. If you want to forward real scam messages to authorities, follow legal procedures and get consent where required. 🛑📜