PhishGuard – AI-Powered Email Threat Detector

🧠 Project Overview

PhishGuard is an AI-powered tool that detects phishing emails using Google’s Generative AI. Users can paste email content into a simple web interface and get instant results. It uses natural language understanding to assess the threat level. Built with Flask and JavaScript, it's lightweight and easy to use.

🧰 Tools & Technologies

Languages: Python 3, JavaScript, HTML, CSS
Libraries: Flask, Flask-CORS, python-dotenv, google-generativeai
Tools: Google Generative AI (Gemini API)
Frontend: HTML, CSS, JavaScript
OS: Windows, macOS, Linux

✨ Key Features

Analyzes email content using Google’s Generative AI (Gemini API)
Detects phishing intent with natural language understanding
Simple web interface for quick input and real-time results
Secures API key using environment variables (.env)
Lightweight Flask-based backend with CORS support
Auto-launches the web interface in your browser

📂 File Structure


phishing-email-detector/
├── app.py
├── .env
├── requirements.txt
├── frontend/
│   ├── index.html
│   ├── style.css
│   └── script.js

🚀 How to Use

Step 1: Clone the Repository

$ git clone https://github.com/chandruthehacker/phising-email-detector.git

Step 2: Navigate to the Project Directory

$ cd phising-email-detector

Step 3: Create a Virtual Environment

For Windows:

$ python -m venv venv

$ venv\Scripts\activate

For macOS / Linux:

$ python3 -m venv venv

$ source venv/bin/activate

Step 4: Install Required Dependencies

$ pip install -r requirements.txt

Step 5: Run the Application

$ python app.py

Step 6: Enter Your Google Generative AI API Key

Get your API key from API link click here https://aistudio.google.com/app/apikey and paste it in the terminal when prompted.

💻 Source Code

phising-email-detector

🎥 Demo Video

👨‍💻 Author Info

Created by Chandraprakash C – BSc Computer Science | Cybersecurity Enthusiast
cyberchandru87@gmail.com | GitHub | LinkedIn

“Think before you click. Detect before you risk.”