https://github.com/cyberytti/toolhunt
This is a local search engine to search for cybersecurity tools. It has 3000+ tools in it's database.
https://github.com/cyberytti/toolhunt
cyber-security cyberpunkui cybersecurity ethical-hacking ethical-hacking-tools ethicalhacking hacking-tool hacking-tools hackingtool hackingtools linux linux-shell python search-engine semantic-search tools webapp
Last synced: 4 months ago
JSON representation
This is a local search engine to search for cybersecurity tools. It has 3000+ tools in it's database.
- Host: GitHub
- URL: https://github.com/cyberytti/toolhunt
- Owner: cyberytti
- License: gpl-3.0
- Created: 2025-09-02T21:15:41.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-09-10T19:23:44.000Z (4 months ago)
- Last Synced: 2025-09-10T23:32:37.598Z (4 months ago)
- Topics: cyber-security, cyberpunkui, cybersecurity, ethical-hacking, ethical-hacking-tools, ethicalhacking, hacking-tool, hacking-tools, hackingtool, hackingtools, linux, linux-shell, python, search-engine, semantic-search, tools, webapp
- Language: HTML
- Homepage:
- Size: 7.87 MB
- Stars: 9
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
*Cyberpunk-styled main interface with immersive terminal aesthetic*
### Search Results
*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
```plaintext
ToolHunt/
├── 🐍 app.py # Main Flask application
├── 🔧 backend/
│ ├── main.py # Search orchestration
│ ├── semantic_search.py # Hybrid search implementation
│ └── database/
│ └── tool_list_database.csv # 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
```bash
# 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
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](LICENSE) file for details.
---
ToolHunt 🔍 - Empowering Cybersecurity Professionals Worldwide
Built with ❤️ by the cybersecurity community
