Skip to main content

AI-powered phishing detector for URLs and emails

Project description

Phishing Detector

Detecteur de phishing base sur le Machine Learning et la Programmation Orientee Objet en Python. Detecte les URLs et emails de phishing en temps reel depuis nimporte ou dans le terminal.

Installation via PyPI (recommande)

pip install isphishing
isphishing-setup
isphishing

Installation via GitHub

Linux / Mac

git clone https://github.com/f3d4yn/phishing-detector.git
cd phishing-detector
chmod +x install.sh
./install.sh
source ~/.bashrc

Windows

git clone https://github.com/f3d4yn/phishing-detector.git
cd phishing-detector
install.bat

Redemarre le terminal apres installation puis tape : isphishing

Performance du modele

Metrique Score
Exactitude 95.52%
Precision 95.79%
Rappel 95.54%
F1 Score 95.66%
ROC AUC 98.76%

Entraine sur 93 916 echantillons (11 430 URLs + 82 486 Emails)

Architecture POO

  • BaseInput : Classe abstraite (ABC)
  • EmailInput : Heritage + validate()
  • URLInput : Heritage + extract_domain()
  • FeatureExtractor : Extraction de 12 features
  • MLModel : Random Forest (100 arbres)
  • PhishingDetector : Orchestrateur principal
  • ThreatReport : Score + Label + Raisons
  • AlertSystem : Alertes + Logs

Lancer les tests

source venv/bin/activate
python -m unittest discover tests/

Note sur les datasets

Les datasets ne sont pas inclus dans le depot. Pour reentrainer le modele :

  1. Telecharge les datasets sur Kaggle :

    • URLs : Web Page Phishing Detection Dataset
    • Emails: Phishing Email Dataset
  2. Place-les dans data/ :

    • data/phishing_dataset.csv
    • data/email_dataset.csv
  3. Lance l entrainement : python train.py

Auteurs

Habib Ilyas et Boukyod Abdessamad Module : Programmation Avancee (Python POO)

PyPI

https://pypi.org/project/isphishing/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

isphishing-1.0.7.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

isphishing-1.0.7-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file isphishing-1.0.7.tar.gz.

File metadata

  • Download URL: isphishing-1.0.7.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for isphishing-1.0.7.tar.gz
Algorithm Hash digest
SHA256 a0b8dc77a9211466892543e26771d71d1be51c753f7d181601a641c4f94e7a2c
MD5 153258dd311caeae66eb214fb440895b
BLAKE2b-256 824a7293e774fb901c9a6865361a0258aed7c2388971f7ab7a62e9b8db0ea0a6

See more details on using hashes here.

File details

Details for the file isphishing-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: isphishing-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 20.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for isphishing-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 0489cb37403cbf8ebea325233f3d39bcc676576530aec109e3581aff5373b8a1
MD5 ad46a36169e70971900fed50ec61b2d6
BLAKE2b-256 d1d5c89c9ce4a25173a5f0c39f30a24369b156017430a771b677b62a2eaa5463

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page