https://github.com/anudeepjonnada/phishshield-ai
🛡️ PhishShield AI – An intelligent phishing email detector that uses BERT and Machine Learning to identify phishing attempts in real time. Integrated with the Gmail API, powered by Flask, React, and MongoDB for secure full-stack email analysis and threat detection.
https://github.com/anudeepjonnada/phishshield-ai
bert flask gmail-api mongodb oauth2 python react scikit-learn
Last synced: 3 months ago
JSON representation
🛡️ PhishShield AI – An intelligent phishing email detector that uses BERT and Machine Learning to identify phishing attempts in real time. Integrated with the Gmail API, powered by Flask, React, and MongoDB for secure full-stack email analysis and threat detection.
- Host: GitHub
- URL: https://github.com/anudeepjonnada/phishshield-ai
- Owner: AnudeepJonnada
- License: mit
- Created: 2025-11-10T10:04:23.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-11-11T01:50:39.000Z (3 months ago)
- Last Synced: 2025-11-11T03:22:51.415Z (3 months ago)
- Topics: bert, flask, gmail-api, mongodb, oauth2, python, react, scikit-learn
- Language: Python
- Homepage:
- Size: 187 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PhishShield AI – Intelligent Phishing Email Detector
An AI-powered system that detects phishing emails using BERT and scikit-learn, integrated with Gmail API and MongoDB.
## Features
- Real-time phishing email detection
- Gmail API integration for email scanning
- BERT-based NLP model for advanced detection
- MongoDB for storing email analysis results
- React frontend for user interface
- Flask REST API backend
## Tech Stack
- **Backend**: Python (Flask), scikit-learn, BERT
- **Database**: MongoDB
- **APIs**: Gmail API
- **Frontend**: React
- **ML Models**: BERT, scikit-learn
## 🎥 Demo Video
Experience **PhishShield AI** in action — see how it scans Gmail inboxes, detects phishing attempts with BERT, and stores analysis results in MongoDB.
[](demo/phishshield_demo.mp4)
## Setup
### Backend Setup
```bash
cd backend
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python app.py
```
### Frontend Setup
```bash
cd frontend
npm install
npm start
```
## Configuration
1. Set up Gmail API credentials in `backend/config/gmail_credentials.json`
2. Configure MongoDB connection in `backend/config.py`
3. Set environment variables in `.env` file
## Usage
1. Authenticate with Gmail API
2. Scan emails for phishing attempts
3. View detailed analysis and threat scores
4. Review historical detection data in MongoDB