125 lines
4.9 KiB
Markdown
125 lines
4.9 KiB
Markdown
# 🛡️ AntiScam Pro
|
||
|
||
[](https://www.python.org/)
|
||
[](LICENSE)
|
||
[](https://github.com/zvspany/antiscam-pro)
|
||
[](https://github.com/zvspany/antiscam-pro/pulls)
|
||
|
||
---
|
||
|
||
**AntiScam Pro** is a modern, open-source security toolkit designed to detect **phishing, scam, and spam** in messages, phone numbers, and URLs.
|
||
It combines **AI-powered analysis (BERT)**, **heuristic detection**, and **VirusTotal integration** to deliver precise, transparent, and explainable results.
|
||
|
||
---
|
||
|
||
## ✨ Key Features
|
||
|
||
- 🤖 **AI-powered message classification** – fine-tuned BERT model detects phishing or spam text.
|
||
- 🔗 **Smart URL inspection** – resolves redirects, short links, and checks domains via VirusTotal.
|
||
- 📞 **Phone number validation** – detects known or suspicious scam numbers.
|
||
- 🌐 **REST API + Web UI** – interact easily from a browser or programmatically.
|
||
- 📊 **Session & global statistics** – track analysis metrics over time.
|
||
- 🔒 **Privacy-first design** – no data is stored or sent externally.
|
||
|
||
---
|
||
|
||
## ⚙️ Installation
|
||
|
||
```bash
|
||
git clone https://github.com/zvspany/antiscam-pro.git
|
||
cd antiscam-pro
|
||
pip install -r requirements.txt
|
||
```
|
||
If you want to enable **VirusTotal integration**, create `.env` file in the project root:
|
||
```
|
||
VIRUSTOTAL_API_KEY=your_api_key_here
|
||
FLASK_SECRET_KEY=change_this_secret
|
||
```
|
||
Then run the app:
|
||
```
|
||
python app.py
|
||
```
|
||
Access the dashboard at:
|
||
👉 http://127.0.0.1:5000
|
||
|
||
---
|
||
|
||
## 💬 Usage
|
||
**You can use AntiScam Pro either from the browser UI or the API endpoints.**
|
||
|
||
---
|
||
|
||
## 🧠 How It Works
|
||
AntiScam Pro applies **multi-layered analysis** for high accuracy and interpretability:
|
||
**1. Input Validation** – detects whether the user provided a message, URL, or number.
|
||
**2. Heuristic Filters** – scans for known scam keywords, shorteners, or flagged domains.
|
||
**3. AI Classification** – BERT model predicts whether text is phishing, spam, or safe.
|
||
**4. External Intelligence** – optional VirusTotal API check for additional reputation data.
|
||
**5. Decision Fusion** – merges signals into a single final verdict.
|
||
This architecture ensures both **speed** and **transparency**, making it suitable for research and production use.
|
||
|
||
---
|
||
|
||
## 🧰 Tech Stack
|
||
- **🐍 Python 3** + **Flask** – lightweight and fast backend
|
||
- **🤗 HuggingFace Transformers (BERT)** – machine learning for text analysis
|
||
- **🌍 Requests** – robust HTTP handling
|
||
- **🧩 VirusTotal API** – optional link intelligence
|
||
- **⚙️ Regex** + **heuristic rules** – simple but effective early filtering
|
||
|
||
---
|
||
|
||
## 🪶 Design Philosophy
|
||
|
||
AntiScam Pro is built around four core principles:
|
||
**🕵️♂️ Transparency** – detection logic is fully open and auditable
|
||
**⚡ Simplicity** – lightweight, minimal dependencies
|
||
**🔐 Privacy** – no user tracking, no telemetry, no cloud sync
|
||
**🧩 Extensibility** – easy to add models, blacklists, or new APIs
|
||
|
||
---
|
||
|
||
## 🤝 Contributing
|
||
Contributions are welcome!
|
||
If you’d like to enhance detection logic, optimize performance, or improve UI/UX — open a pull request or issue.
|
||
Let's build a safer digital world, together 💙
|
||
|
||
---
|
||
|
||
## 📜 License
|
||
This project is released under the **MIT License**.
|
||
```
|
||
MIT License
|
||
|
||
Copyright (c) 2025 zvspany
|
||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
of this software and associated documentation files (the “Software”), to deal
|
||
in the Software without restriction, including without limitation the rights
|
||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
copies of the Software, and to permit persons to whom the Software is
|
||
furnished to do so, subject to the following conditions:
|
||
|
||
The above copyright notice and this permission notice shall be included in all
|
||
copies or substantial portions of the Software.
|
||
|
||
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||
THE SOFTWARE.
|
||
```
|
||
|
||
---
|
||
|
||
## ❤️ Acknowledgements
|
||
Built by [@zvspany](https://zvspany.github.io/bio/)
|
||
Inspired by the fight against online scams, phishing, and misinformation.
|
||
Powered by the open-source community 🌍
|
||
|
||
---
|
||
|
||
🧩 *[AntiScam Pro](https://github.com/zvspany/antiscam-pro) — because cybersecurity should be transparent, intelligent, and free.*
|