{"id":31025758,"url":"https://github.com/cyberytti/toolhunt","last_synced_at":"2025-09-13T17:12:44.346Z","repository":{"id":312932329,"uuid":"1049353969","full_name":"cyberytti/ToolHunt","owner":"cyberytti","description":"This is a local search engine to search for cybersecurity tools. It has 3000+ tools in it's database.","archived":false,"fork":false,"pushed_at":"2025-09-10T19:23:44.000Z","size":8257,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-10T23:32:37.598Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cyberytti.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-02T21:15:41.000Z","updated_at":"2025-09-10T22:45:37.000Z","dependencies_parsed_at":"2025-09-02T23:18:35.684Z","dependency_job_id":"34db0ff3-64d2-464f-90a2-923c48b84c97","html_url":"https://github.com/cyberytti/ToolHunt","commit_stats":null,"previous_names":["cyberytti/toolhunt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cyberytti/ToolHunt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberytti%2FToolHunt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberytti%2FToolHunt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberytti%2FToolHunt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberytti%2FToolHunt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyberytti","download_url":"https://codeload.github.com/cyberytti/ToolHunt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyberytti%2FToolHunt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274997547,"owners_count":25387934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-09-13T17:12:43.220Z","updated_at":"2025-09-13T17:12:44.337Z","avatar_url":"https://github.com/cyberytti.png","language":"HTML","readme":"# ToolHunt 🔍\n*Advance search engine for finding cybersecurity tools that match different needs.*\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/cyberytti/ToolHunt/blob/main/docs/logo/ToolHunt_logo.png\" alt=\"ToolHunt Logo\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Tools-3000+-brightgreen?style=for-the-badge\u0026logo=hammer-screwdriver\" alt=\"3000+ Tools\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python-3.12+-blue?style=for-the-badge\u0026logo=python\" alt=\"Python 3.12+\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Flask-2.0+-red?style=for-the-badge\u0026logo=flask\" alt=\"Flask 2.0+\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-GNU-green?style=for-the-badge\u0026logo=gnu\" alt=\"GNU License\"/\u003e\n\u003c/p\u003e\n\n---\n\n## 🌟 Overview\n\nToolHunt 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.\n\n---\n\n## 🚀 Key Features\n\n| Feature | Description |\n|---------|-------------|\n| 🔍 **Semantic Search Engine** | Advanced AI-powered search using sentence transformers and FAISS vector similarity |\n| 🗃️ **Comprehensive Database** | 3,000+ cybersecurity tools across multiple categories and specialties |\n| ⚡ **Hybrid Search Algorithm** | Combines semantic search with BM25 keyword matching for optimal relevance |\n| 🎮 **Cyberpunk Interface** | Immersive terminal-inspired dark UI with animated backgrounds |\n| ☁️ **Cloud Deployment** | One-click Google Colab deployment with ngrok tunneling |\n| 📱 **Responsive Design** | Works seamlessly on desktop, tablet, and mobile devices |\n\n---\n\n## 🎥 Live Demo\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/cyberytti/ToolHunt/blob/main/docs/showcase_video/ToolHunt_showcase_video.gif\" alt=\"ToolHunt Demo\" width=\"800\"/\u003e\n\u003c/p\u003e\n\n---\n\n## 📸 Screenshots\n\n### Main Search Interface\n![Main Search Interface](https://github.com/cyberytti/ToolHunt/blob/main/docs/showcase_images/Screenshot%20from%202025-09-04%2015-57-39.png)\n*Cyberpunk-styled main interface with immersive terminal aesthetic*\n\n### Search Results\n![Search Results Display](https://github.com/cyberytti/ToolHunt/blob/main/docs/showcase_images/Screenshot%20from%202025-09-04%2015-58-40.png)\n*Intelligent tool categorization with detailed descriptions*\n\n---\n\n## 🛠️ Technology Stack\n\n### Frontend\n| Technology | Purpose |\n|------------|---------|\n| ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=flat-square\u0026logo=html5\u0026logoColor=white) | Structure \u0026 Semantics |\n| ![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=flat-square\u0026logo=css3\u0026logoColor=white) | Cyberpunk Styling |\n| ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=flat-square\u0026logo=javascript\u0026logoColor=black) | Dynamic Interactions |\n| ![Font Awesome](https://img.shields.io/badge/Font_Awesome-528DD7?style=flat-square\u0026logo=font-awesome\u0026logoColor=white) | Security Icons |\n\n### Backend\n| Technology | Purpose |\n|------------|---------|\n| ![Flask](https://img.shields.io/badge/Flask-000000?style=flat-square\u0026logo=flask\u0026logoColor=white) | Web Framework |\n| ![Python](https://img.shields.io/badge/Python-3776AB?style=flat-square\u0026logo=python\u0026logoColor=white) | Core Language |\n\n### Search Engine\n| Technology | Purpose |\n|------------|---------|\n| ![LangChain](https://img.shields.io/badge/LangChain-FF6B00?style=flat-square) | Similarity Search |\n| ![HuggingFace](https://img.shields.io/badge/HuggingFace-FFD21E?style=flat-square\u0026logo=huggingface\u0026logoColor=black) | Sentence Embeddings |\n| ![FAISS](https://img.shields.io/badge/FAISS-00C2FF?style=flat-square) | Vector Similarity |\n| ![BM25](https://img.shields.io/badge/BM25-8A2BE2?style=flat-square) | Keyword Matching |\n\n---\n\n## 📁 Project Structure\n\n```plaintext\nToolHunt/\n├── 🐍 app.py                      # Main Flask application\n├── 🔧 backend/\n│   ├── main.py                # Search orchestration\n│   ├── semantic_search.py     # Hybrid search implementation\n│   └── database/\n│       └── tool_list_database.csv  # 3000+ tools database\n├── 🎨 templates/\n│   └── index.html            # Cyberpunk interface\n├── ☁️ toolhunt_in_colab.py      # Google Colab deployment\n├── ⚙️ pyproject.toml            # Project configuration\n├── 📦 uv.lock                   # Dependency lock\n├── 📄 LICENSE                   # GNU License\n└── 📖 README.md                 # You are here!\n```\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Python 3.12+\n- pip package manager\n\n### Local Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/cyberytti/ToolHunt.git\ncd ToolHunt\n\n# Install dependencies\npip install -r requirements.txt\n\n# Launch ToolHunt\npython app.py\n```\n\nAccess your local instance at: `http://localhost:5000`\n\n### ☁️ One-Click Cloud Deployment\n\n![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)\n\nThis search engine needs a GPU.\n\nWe’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.\n\n---\n\n## 🔍 Usage Examples\n\n| Search Type | Example Queries |\n|-------------|-----------------|\n| **Network Security** | `\"network scanner\"`, `\"port enumeration tools\"` |\n| **Web Application** | `\"sql injection tools\"`, `\"web vulnerability scanner\"` |\n| **Password Attacks** | `\"password cracking utilities\"`, `\"brute force tools\"` |\n| **Forensics** | `\"digital forensics analysis\"`, `\"memory analysis tools\"` |\n| **Reconnaissance** | `\"OSINT gathering tools\"`, `\"subdomain enumeration\"` |\n\n---\n\n## 💾 Database Schema\n\nThe comprehensive database includes:\n\n| Field | Description |\n|-------|-------------|\n| **Tool Name** | Official tool name |\n| **Description** | Detailed functionality description |\n| **Category** | Primary cybersecurity category |\n| **Link** | Official documentation/download URL |\n| **Platform** | Supported operating systems |\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions from the cybersecurity community!\n\n### Development Process\n1. 🍴 Fork the repository\n2. 🌿 Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. 💻 Make your changes\n4. ✅ Test thoroughly\n5. 📝 Commit your changes (`git commit -m 'Add amazing feature'`)\n6. 📤 Push to the branch (`git push origin feature/amazing-feature`)\n7. 🔀 Open a Pull Request\n\n### Guidelines\n- Follow PEP 8 style guidelines\n- Maintain the cyberpunk aesthetic\n- Test search functionality with various queries\n- Update documentation for new features\n\n---\n\n## ⚖️ Ethical Use\n\n\u003e **Important**: ToolHunt is designed for legitimate cybersecurity purposes only.\n\n**Responsible Usage Guidelines:**\n- 🔒 Use only on systems you own or have explicit permission to test\n- 📜 Comply with all applicable laws and regulations\n- 🤝 Follow responsible disclosure practices\n- 📋 Respect terms of service for included tools\n\n---\n\n## 📄 License\n\nThis project is licensed under the **GNU License** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eToolHunt 🔍 - Empowering Cybersecurity Professionals Worldwide\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eBuilt with ❤️ by the cybersecurity community\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/cyberytti/ToolHunt/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/cyberytti/ToolHunt?style=social\" alt=\"GitHub stars\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/cyberytti/ToolHunt/fork\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/cyberytti/ToolHunt?style=social\" alt=\"GitHub forks\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberytti%2Ftoolhunt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyberytti%2Ftoolhunt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyberytti%2Ftoolhunt/lists"}