Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

cyberytti/ToolHunt

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