Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

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 <System Python File PATH>/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.

Files for fluffypancakes, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size fluffypancakes-0.1.5-py3-none-any.whl (17.3 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size fluffypancakes-0.1.5.tar.gz (17.3 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page