Skip to content

This is a local search engine to search for cybersecurity tools. It has 3000+ tools in it's database.

License

Notifications You must be signed in to change notification settings

cyberytti/ToolHunt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

36 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ToolHunt ๐Ÿ”

Advance search engine for finding cybersecurity tools that match different needs.

ToolHunt Logo

3000+ Tools Python 3.12+ Flask 2.0+ GNU License


๐ŸŒŸ Overview

ToolHunt is an advanced search engine that helps you quickly find the right cybersecurity tool from a database of over 3,000 options. Just describe what you need in plain language, and its smart, elastic search will return the best matches for security pros, pentesters, and researchers.


๐Ÿš€ Key Features

Feature Description
๐Ÿ” Semantic Search Engine Advanced AI-powered search using sentence transformers and FAISS vector similarity
๐Ÿ—ƒ๏ธ Comprehensive Database 3,000+ cybersecurity tools across multiple categories and specialties
โšก Hybrid Search Algorithm Combines semantic search with BM25 keyword matching for optimal relevance
๐ŸŽฎ Cyberpunk Interface Immersive terminal-inspired dark UI with animated backgrounds
โ˜๏ธ Cloud Deployment One-click Google Colab deployment with ngrok tunneling
๐Ÿ“ฑ Responsive Design Works seamlessly on desktop, tablet, and mobile devices

๐ŸŽฅ Live Demo

ToolHunt Demo


๐Ÿ“ธ Screenshots

Main Search Interface

Main Search Interface Cyberpunk-styled main interface with immersive terminal aesthetic

Search Results

Search Results Display Intelligent tool categorization with detailed descriptions


๐Ÿ› ๏ธ Technology Stack

Frontend

Technology Purpose
HTML5 Structure & Semantics
CSS3 Cyberpunk Styling
JavaScript Dynamic Interactions
Font Awesome Security Icons

Backend

Technology Purpose
Flask Web Framework
Python Core Language

Search Engine

Technology Purpose
LangChain Similarity Search
HuggingFace Sentence Embeddings
FAISS Vector Similarity
BM25 Keyword Matching

๐Ÿ“ Project Structure

ToolHunt/
โ”œโ”€โ”€ ๐Ÿ app.py                      # Main Flask application
โ”œโ”€โ”€ ๐Ÿ”ง backend/
โ”‚   โ”œโ”€โ”€ main.py                # Search orchestration
โ”‚   โ”œโ”€โ”€ semantic_search.py     # Hybrid search implementation
โ”‚   โ””โ”€โ”€ database/
โ”‚       โ””โ”€โ”€ tools.db  # 3000+ tools database
โ”œโ”€โ”€ ๐ŸŽจ templates/
โ”‚   โ””โ”€โ”€ index.html            # Cyberpunk interface
โ”œโ”€โ”€ โ˜๏ธ toolhunt_in_colab.py      # Google Colab deployment
โ”œโ”€โ”€ โš™๏ธ pyproject.toml            # Project configuration
โ”œโ”€โ”€ ๐Ÿ“ฆ uv.lock                   # Dependency lock
โ”œโ”€โ”€ ๐Ÿ“„ LICENSE                   # GNU License
โ””โ”€โ”€ ๐Ÿ“– README.md                 # You are here!

๐Ÿš€ Quick Start

Prerequisites

  • Python 3.12+
  • pip package manager

Local Installation

# Clone the repository
git clone https://github.com/cyberytti/ToolHunt.git
cd ToolHunt

# Install dependencies
pip install -r requirements.txt

# Launch ToolHunt
python app.py

Access your local instance at: http://localhost:5000

โ˜๏ธ One-Click Cloud Deployment

Open in Colab

This search engine needs a GPU.

Weโ€™ve made it easy: open the Colab notebook, pick a T4 GPU, paste your ngrok token, and run the file toolhunt_in_colab.py. Colab will give you a public link to use ToolHunt right away.


๐Ÿ” Usage Examples

Search Type Example Queries
Network Security "network scanner", "port enumeration tools"
Web Application "sql injection tools", "web vulnerability scanner"
Password Attacks "password cracking utilities", "brute force tools"
Forensics "digital forensics analysis", "memory analysis tools"
Reconnaissance "OSINT gathering tools", "subdomain enumeration"

๐Ÿ’พ Database Schema

The comprehensive database includes:

Field Description
Tool Name Official tool name
Description Detailed functionality description
Category Primary cybersecurity category
Link Official documentation/download URL
Platform Supported operating systems

๐Ÿค Contributing

We welcome contributions from the cybersecurity community!

Development Process

  1. ๐Ÿด Fork the repository
  2. ๐ŸŒฟ Create a feature branch (git checkout -b feature/amazing-feature)
  3. ๐Ÿ’ป Make your changes
  4. โœ… Test thoroughly
  5. ๐Ÿ“ Commit your changes (git commit -m 'Add amazing feature')
  6. ๐Ÿ“ค Push to the branch (git push origin feature/amazing-feature)
  7. ๐Ÿ”€ Open a Pull Request

Guidelines

  • Follow PEP 8 style guidelines
  • Maintain the cyberpunk aesthetic
  • Test search functionality with various queries
  • Update documentation for new features

โš–๏ธ Ethical Use

Important: ToolHunt is designed for legitimate cybersecurity purposes only.

Responsible Usage Guidelines:

  • ๐Ÿ”’ Use only on systems you own or have explicit permission to test
  • ๐Ÿ“œ Comply with all applicable laws and regulations
  • ๐Ÿค Follow responsible disclosure practices
  • ๐Ÿ“‹ Respect terms of service for included tools

๐Ÿ“„ License

This project is licensed under the GNU License - see the LICENSE file for details.


ToolHunt ๐Ÿ” - Empowering Cybersecurity Professionals Worldwide

Built with โค๏ธ by the cybersecurity community

GitHub stars GitHub forks