ToolHunt 🔍

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

🌟 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

📸 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 | |------------|---------| | | Structure & Semantics | | | Cyberpunk Styling | | | Dynamic Interactions | | | Security Icons |

Backend

| Technology | Purpose | |------------|---------| | | Web Framework | | | Core Language |

Search Engine

| Technology | Purpose | |------------|---------| | | Similarity Search | | | Sentence Embeddings | | | Vector Similarity | | | 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

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

🍴 Fork the repository
🌿 Create a feature branch (git checkout -b feature/amazing-feature)
💻 Make your changes
✅ Test thoroughly
📝 Commit your changes (git commit -m 'Add amazing feature')
📤 Push to the branch (git push origin feature/amazing-feature)
🔀 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 <a href="https://github.com/cyberytti/ToolHunt/stargazers"> <img src="https://img.shields.io/github/stars/cyberytti/ToolHunt?style=social" alt="GitHub stars"/> </a> <a href="https://github.com/cyberytti/ToolHunt/fork"> <img src="https://img.shields.io/github/forks/cyberytti/ToolHunt?style=social" alt="GitHub forks"/> </a>

ToolHunt

Install / Use

README