Skip to content

sanjayh-2022/_ThreatSleuth

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Threat Sleuth

Threat Sleuth is a cutting-edge tool designed to keep you safe from phishing attempts, malicious URLs, and spam emails/messages. With an intuitive web interface and a handy browser extension, it provides robust protection and helps users report false positives to improve the detection system.

Features

🌐 Web Interface

  • Check URLs: Instantly verify if a URL is malicious or safe.
  • Email/Message Analysis: Detect phishing or spam content in emails and messages.
  • Report False Positives: Contribute to improving the detection system by reporting false positives.

🔒 Browser Extension

  • Automatic Detection: The extension alerts users when they open a potentially malicious URL.
  • One-Click Safety: Scan links directly from your browser without switching tabs.




🛠️ Getting Started

1. Clone the Repository

git clone https://github.com/sanjayh-2022/_ThreatSleuth.git

Navigate to the project directory:

cd _ThreatSleuth

Install dependencies:

npm i
pip install pandas numpy tld joblib

Run Locally

Start the development server :

node index.js

##Set up the extension

    1. Go to Chrome click on manage extensions and turn on the developer mode
    2. Click on "load unpacked" and select the "extension" folder which is on your desktop's ThreatSleuth folder
    3. Your Chrome extension is ready. Go to any website and click on the extension

For the Website

The website has a separate setup process. Refer to the README file for detailed instructions.

Contributing

Contributions are welcome! If you find any bugs or have suggestions for improvements, please open an issue or clone the repository and submit a pull request on GitHub.

For detailed guidelines on how to contribute, please refer to the CONTRIBUTING.md file

License

This project is licensed under the MIT License. See LICENSE for more details