PhishGuard is an enterprise-grade, fully automated software suite designed to analyze incoming emails in real-time and detect phishing attacks using advanced Machine Learning.
With human error being the leading cause of cybersecurity breaches, PhishGuard acts as an intelligent, invisible shield. It seamlessly parses email headers, extracts URLs, and evaluates body content, scoring threat levels and automatically organizing or quarantining suspicious messages before they reach the user.
- 🧠 AI-Powered Detection: Leverages BERT (Bidirectional Encoder Representations from Transformers) fine-tuned for high-accuracy deceptive language and phishing detection.
- 📨 Native Gmail Integration: Connects directly to your Gmail workflow via the official Gmail API to scan incoming mail dynamically and safely.
- 🖥️ Modern Desktop GUI: Sleek, fully-featured desktop user interface built on PySide6, providing a real-time analytics dashboard and granular controls.
- 🗄️ Robust Data Pipeline: Backed by PostgreSQL & Alembic, ensuring reliable historical data logging, migrations, and metric evaluation.
- 📊 Security Analytics: Automatically generates reports, interactive charts, and real-time metric tracking for continuous security monitoring.
| Category | Technology |
|---|---|
| Core & Engine | Python 3.10+ |
| Machine Learning | BERT, PyTorch / HuggingFace Transformers |
| GUI Framework | PySide6 (Qt for Python) |
| Database | PostgreSQL, SQLAlchemy, Alembic |
| Integrations | Google Cloud Console, Gmail API |
- Python 3.10 or higher
- PostgreSQL Server installed and running
- Google Cloud Console Account (for generating
credentials.jsonfor the Gmail API)
-
Clone the repository
git clone https://github.com/Azamaperdeev05/PhishGuard.git cd PhishGuard -
Install dependencies
pip install -r requirements.txt
-
Database Configuration Setup Configure your database details in
.env. Apply Alembic migrations to set up the schema:alembic upgrade head
-
Launch the Application Start the desktop dashboard interface:
python run_gui.py
Built with ❤️ by Azamat Perdeev
- 🐙 GitHub: @Azamaperdeev05
- 📧 Contact: azamaperdeev05@gmail.com
- ☕ Support the Project / Donate: donat-woad.vercel.app
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for more details.