A simple, open-source phishing email detector for everyone.
Phishing attacks trick users into revealing sensitive info, causing data breaches, financial loss, and reputation damage. Early detection helps protect you, your team, and your business from email-based threats.
- Detects phishing emails using machine learning
- Easy-to-use Python interface
- Customizable detection rules
- Clear alerts & summaries
- Lightweight & fast
- Open-source and free!
- Input: You provide an email (text or file).
- Analysis: FishEye scans for suspicious links, sender info, and content patterns.
- Detection: Uses machine learning to classify phishing attempts.
- Output: Shows a clear result — Safe ✅ or Phishing
⚠️
# Clone the repo
git clone https://github.com/alilo113/fisheye.git
# Move into the project directory
cd fisheye
# (Optional) Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate
# Install dependencies
pip install -r requirements.txtBasic command-line example:
python fisheye.py --email path/to/email.txtOr scan an email directly:
from fisheye import scan_email
result = scan_email("Suspicious email content here")
print(result)Screenshot Example:
See FishEye in action!
- Scans real emails in seconds
- Highlights suspicious elements
- Provides easy-to-understand results
Check out the demo folder for sample runs and screenshots.
We love your ideas and improvements!
- Fork the repo
- Create your feature branch (
git checkout -b feature/my-feature) - Commit changes (
git commit -am 'Add new feature') - Push to branch (
git push origin feature/my-feature) - Open a Pull Request
This project is licensed under the MIT License.
Ready to catch more phish? Star ⭐ FishEye and help keep the community safe!
Designed for easy conversion into Instagram carousel slides — each section can be a slide.