HOS
Open Source MIT License v1.0.0

AI Phishing Email Detector

Defend. Detect. Automate.

An AI-powered email classification system designed to detect phishing emails based on their content and header structure.

LanguagePython
UI EngineTkinter GUI
ML TechScikit-learn
CategoryCybersecurity AI

Overview

This project is an AI-powered email classification system designed to detect phishing emails based on their content and header structure. It uses machine learning for classification and features a user-friendly GUI built with Tkinter for real-time analysis.

Project Objectives

  • Analyze email content and headers for phishing indicators.
  • Train a supervised machine learning model (Naive Bayes / Logistic Regression).
  • Build a GUI for easy email input and real-time phishing detection.
  • Achieve high accuracy with explainable results.

Key Features

Supervised ML Engine

Classifies emails using trained models (Naive Bayes / Logistic Regression).

Heuristic Extraction

Scans suspicious keywords, header anomalies (e.g. mismatched sender path), URL structures, and attachments.

Tkinter Desktop GUI

Load or paste an email block into a desktop program for instant threat predictions.

Metrics Indicators

Displays classification reasons and indicators to explain why a decision was reached.

Project Structure

AI-phishing-email-detector/
├── phishing_detector.py      # Email parsing, feature extraction, model training
├── gui.py                   # Tkinter GUI for real-time detection
├── model.pkl                # Trained ML model file
├── data/                    # Sample datasets (PhishTank, SpamAssassin)
├── requirements.txt         # Python dependencies
└── README.md                # Project documentation
                    

Model Evaluation

Our model evaluates incoming traffic against historical classification benchmarks using standard split training sets:

98% Accuracy
97% Precision
99% Recall
98% F1-Score

Future Improvements

  • Add support for deep learning models (e.g. LSTM, BERT).
  • Deploy as a browser/email plugin for real-time protection.
  • Add explanation for classification decisions using SHAP/LIME tools.

Technical Specifications

Python Language
Scikit-Learn ML Framework
Tkinter GUI Library
NLTK NLP Engine

Installation

Step 1: Clone the repository

git clone https://github.com/Amegh3/AI-phishing-email-detector.git

Step 2: Install dependencies

pip install -r requirements.txt

Step 3: Run the local GUI

python gui.py

GitHub Statistics

56 Stars
14 Forks
0 Issues
3 Contributors
38 Commits
5 days ago Updated

Contributors

Community channels

Discussions

Join our GitHub community

WhatsApp

Live chat with developers

Reddit

Reddit updates & community info