morikeli / spam-slayer

This is a trained ML model that analyzes an email to distinguish between legitimate messages (i.e. ham) and pesky spam.

SpamSlayer

This is a web-based trained machine learning model trained to detect spam or ham emails.

Demo

User instructions

To access the website click here.

• Type an email text in the text area provided
• Click the Submit button to submit the form for analysis
• A success message will be displayed for ham email or error message (for spam email).

Developer instructions

To run the project offline;

• clone the repo to your desired location, e.g. Desktop, Downloads or Documents

• Install Python interpreter on your local machine if you don't have one. In this project, Python v3.11.4 was used.

• Open the project folder using your IDE of choice or use the following commands on:

  1. Terminal

     python3 -m venv .venv
     source .venv/bin/activate
     pip install -r requirements.txt
  

  2. Command prompt (CMD)

    python3 -m venv .venv
    .venv\Scripts\activate
    pip install -r requirements.txt
  

• Once all the packages have been installed, type:

  
      streamlit run main.py
  
  

A browser tab will automatically open on your default browser.

Buy me coffee

Fun fact!

I need coffee to survive. It's like my liquid superhero serum. Be a hero today!

Appreciate the effort put in developing the project by buying me coffee today! 😁