devtitan commited on
Commit
0d6e61f
·
verified ·
1 Parent(s): 2b63236

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +20 -17
README.md CHANGED
@@ -1,24 +1,27 @@
1
- # Phishing Email Detector
 
2
 
3
- ## Description
4
 
5
- This project is a web application built with Flask that analyzes email text content to detect potential phishing attempts. It utilizes a pre-trained machine learning model from the Hugging Face Transformers library to classify emails. [cite: 1]
 
6
 
7
- ## Features
8
 
9
- * Provides a simple web interface to paste and analyze email text.
10
- * Uses the `cybersectony/phishing-email-detection-distilbert_v2.4.1` model for classification. [cite: 1]
11
- * Displays the most likely classification (e.g., "Likely Legitimate", "Suspicious / Phishing Link Likely"). [cite: 1]
12
- * Shows the confidence score for the top prediction. [cite: 1]
13
- * Provides detailed probabilities for all classification categories considered by the model. [cite: 1]
14
 
15
- ## Dependencies
16
 
17
- * Python 3.x
18
- * Flask [cite: 1]
19
- * Hugging Face Transformers (`transformers`) [cite: 1]
20
- * PyTorch (`torch`) [cite: 1]
21
 
22
- You can install the Python dependencies using pip:
23
- ```bash
24
- pip install Flask transformers torch
 
 
 
 
 
 
 
 
 
1
+ ## Phishing Email Detector 🎣
2
+ This project is a web-based tool designed to help users identify potentially malicious phishing emails. By pasting the text content of an email, the application leverages a fine-tuned transformer model from the Hugging Face Hub to analyze the content and classify its likelihood of being a phishing attempt.
3
 
4
+ It serves as a practical, end-to-end example of building and deploying a machine learning application as an interactive web service.
5
 
6
+ ## Key Features
7
+ Simple Web Interface: An easy-to-use text area for pasting email content for analysis.
8
 
9
+ Real-Time Analysis: Utilizes a DistilBERT-based model to provide instant classification.
10
 
11
+ Clear Predictions: Outputs a primary classification (e.g., "Phishing Link Detected", "Legitimate Email") along with a confidence score.
 
 
 
 
12
 
13
+ Detailed Breakdown: Displays the model's confidence scores across all possible output labels for greater transparency.
14
 
15
+ Containerized & Reproducible: Packaged with Docker, ensuring a consistent environment for both development and deployment.
 
 
 
16
 
17
+ ## Tech Stack
18
+ Backend: Python, Flask, Gunicorn
19
+
20
+ Machine Learning: Hugging Face Transformers, PyTorch
21
+
22
+ Frontend: HTML, CSS (via Jinja2 templates)
23
+
24
+ Deployment: Docker, Hugging Face Spaces
25
+
26
+ ## Live Demo
27
+ 🚀 You can try the live application here: