Skip to main content

Detect Phishing Websites using Machine Learning

Project description

Fluffy Pancakes

Fluffy Pancakes is a library designed to detect phishing websites. It uses Machine Learning to predict the output with an accuracy of 95.2%.

Note: Please bear with us for a few seconds to get the output since the library is computationally intensive. We felt bad for making you wait, so we have included a progress bar that you can enable to see the percentage of progress and also see the time taken for execution. Also note that the library heavily depends on a stable internet connection to function its best and to obtain the results. So, the quicker your internet connection is, the faster your results will be :).

Usage

  • Install the module

     $ pip install fluffypancakes
    
  • Grant Permissions

    Use sudo chmod 777 to give permissions to the /site-packages/fluffypancakes/dependencies/ folder.

  • Import

     $ from fluffypancakes import fluffypancakes as fp
    
  • Call the function and Pass the URL

     $ result = fp.serve('<website URL>', progressBar=True)
     $ print(result)
    
  • Defaults

    The default value of the progressBar is 'True'. However, the option can be enabled or disabled with boolean 'True' or 'False' respectively.

Output

-1 : Legitimate Website

1 : Phishing Website

"The URL entered is either Invalid or the Host is unserviceable" : For invalid URLs and Unservicable Hosts

The output is predicted with an accuracy of 95.2%. It is not a definitive classification.

Dependencies

Python dependencies:

  • beautifulsoup4>=4.9.0
  • numpy>=1.17.2
  • pandas>=1.0.4
  • python-whois>=0.7.2
  • requests>=2.23.0
  • scikit-learn>=0.21.3
  • selenium>=3.141.0
  • sklearn>=0.0
  • tqdm>=4.46.0
  • urllib3>=1.25.8

Installing this module will install all the dependencies automatically.

Additional dependencies:

  • Chrome Driver : You'll need a chromedriver in order to complete execution of the code. You can get the file from here. Unzip and add the "chromedriver.exe" (Windows) or "chromedriver" (Linux and MacOS) file to the PYTHONPATH environment variable.

    Well, that's a lot of work right? We know! So, we have included the current stable version of the chromedriver in the dependencies folder of the repo.

    The code automatically detects the OS (Windows, Linux Based and MacOS) and picks up the respective chromedriver file.

    You're all set to go. Although, if, by any chance, you face an issue, just add to PYTHONPATH, the directory structure to where you downloaded this repository.

Development

Want to contribute? Great!

FluffyPancakes uses http requests, bs4, selenium, and of course, Machine Learning, and a lot more libraries. You can find the GitHub repository here.

Make sure you use the following command to get the exact versions of pytest and twine:

$ pip install -e .[dev]

You can find the sample test case here.

Development Status

Development Status :: 4 - Beta
Operating System :: OS Independent

License

MIT


In collaboration with the Center for ISFCR at PES University, Bangalore, India. Special thanks to Mr. Prasad B Honnavali (Director, Center for ISFCR) for his constant support and mentorship.

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

fluffypancakes-0.1.5.tar.gz (17.3 MB view details)

Uploaded Source

Built Distribution

fluffypancakes-0.1.5-py3-none-any.whl (17.3 MB view details)

Uploaded Python 3

File details

Details for the file fluffypancakes-0.1.5.tar.gz.

File metadata

  • Download URL: fluffypancakes-0.1.5.tar.gz
  • Upload date:
  • Size: 17.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.4

File hashes

Hashes for fluffypancakes-0.1.5.tar.gz
Algorithm Hash digest
SHA256 e883fce306165739db36acf18f13ae7b91153f9f68fdda74cf997a61723e94cd
MD5 ad099e67fd76221d17023939491277f3
BLAKE2b-256 ea0374e85e9cda1f255e279bcbeb37de4c7289e5cc132820a52c8be302f697b1

See more details on using hashes here.

File details

Details for the file fluffypancakes-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: fluffypancakes-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 17.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.4

File hashes

Hashes for fluffypancakes-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 46b82df3a207d829ba656d3f46fd2e551663615c5444c6e083281c78a4f2db25
MD5 62002db6fdbcfe751b6a3ad4fa83c256
BLAKE2b-256 f184240f1b23abef897c553d19af3b75e83c486b37b3e02f3b73c0846d68f9f6

See more details on using hashes here.

Supported by

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