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.6.tar.gz (14.9 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.6-py3-none-any.whl (19.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: isphishing-1.0.6.tar.gz
  • Upload date:
  • Size: 14.9 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.6.tar.gz
Algorithm Hash digest
SHA256 c6ee760be58dd0eba08da309830394e75dfb05b6e68a81817af34ca21790605f
MD5 e493a531371b4ddd0fb43a776585acf7
BLAKE2b-256 7d285abf8aa5242abd13345400b96f8c44268881e62c118026b89bab7caf5dd3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: isphishing-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 19.9 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 0991aa9a2f86b763be047b2f6dae9d4448e8ebf5bb98d2330cced0bf022cc345
MD5 59883a7a02dccbfbebbc90c5cef82fe3
BLAKE2b-256 8ec6dff80ae8dd2f8926731abfabf1951e01203581380c6de39955c7bf8ff980

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