{"id":13842966,"url":"https://github.com/nicolas-carolo/houndsploit","last_synced_at":"2025-07-11T17:32:49.898Z","repository":{"id":177304263,"uuid":"158392933","full_name":"nicolas-carolo/houndsploit","owner":"nicolas-carolo","description":"An advanced graphical search engine for Exploit-DB","archived":false,"fork":false,"pushed_at":"2024-05-29T16:45:44.000Z","size":112415,"stargazers_count":116,"open_issues_count":0,"forks_count":20,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-08-05T17:34:48.795Z","etag":null,"topics":["exploit-db","exploits","number-filtering","penetration-testing","search-engine","shellcodes"],"latest_commit_sha":null,"homepage":"https://nicolascarolo.tk/projects/houndsploit/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicolas-carolo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-20T13:21:47.000Z","updated_at":"2024-05-28T13:13:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"ba3c7091-56d6-4e4c-bfeb-de9e85dff34a","html_url":"https://github.com/nicolas-carolo/houndsploit","commit_stats":null,"previous_names":["nicolas-carolo/houndsploit"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolas-carolo%2Fhoundsploit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolas-carolo%2Fhoundsploit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolas-carolo%2Fhoundsploit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolas-carolo%2Fhoundsploit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicolas-carolo","download_url":"https://codeload.github.com/nicolas-carolo/houndsploit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225745396,"owners_count":17517631,"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","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":["exploit-db","exploits","number-filtering","penetration-testing","search-engine","shellcodes"],"created_at":"2024-08-04T17:01:52.480Z","updated_at":"2024-11-21T14:30:34.057Z","avatar_url":"https://github.com/nicolas-carolo.png","language":"Python","funding_links":[],"categories":["Python","Python (1887)"],"sub_categories":[],"readme":"# HoundSploit\n\n![HoundSploit Logo](/HoundSploit/static/media/icon.png)\n\nAuthor: Nicolas Carolo \u003cnicolascarolo.dev@gmail.com\u003e\n\nCopyright: © 2021, Nicolas Carolo.\n\nDate: 2021-11-26\n\nVersion: 2.8.0\n\n\n## PURPOSE\n\n_HoundSploit_ is an advanced search engine for Exploit-DB developed in\nPython using Flask as micro web framework, born with the aim of showing the user\nthe most accurate search results.\n\n### Features\n\n* Effective version number filtering\n* Advanced filtering\n* Sort by date and description\n* Fast search\n* Search suggestions with customization\n* Syntax highlighting of the source code of exploits and shellcodes\n* Downloading of the source code of exploits and shellcodes\n* Highlighting of searched words in search results\n* Bookmarks\n* Fix of exploit and shellcode dates \n* Check for updates (both for software and database)\n\n#### New features in HoundSploit 2\n* Flask instead of Django\n* SQLAlchemy instead of Django ORM\n* The kernel of the search engine is the same used in [_hsploit_](https://github.com/nicolas-carolo/hsploit), which is the CLI version of HoundSploit\n* Dark and Light themes\n\n#### Effective version number filtering examples\n##### Example I\n\n11 exploits and 0 shellcodes found for \"WordPress Core 2.0.2\"\n\n![Search example 1](/img/example-1.png)\n\n\n##### Example II\n\n16 exploits and 0 shellcodes found for \"Linux Kernel 4.2.3\"\n\n![Search example 2](/img/example-2.png)\n\n\n#### Advanced filtering\n\nUsing advanced search you can use the following filters for filtering search\nresults:\n* Search operator: `AND` or `OR`\n* Author\n* Type\n* Platform\n* Port\n* Date interval\n\n![Advanced filtering](/img/advanced-filtering.png)\n\n\n#### Search suggestion\n\nYou can choose to show a particular suggestion for a given searched string.\nFor each case you can also decide to use automatic replacement or not.\nIt is possible to add new suggestions and delete the existing suggestions.\n\n![Suggestions](/img/suggestions.png)\n\n\n#### Bookmarks\n\nYou can add exploits and shellcodes to bookmarks and filter them using the searchbox.\n\n![Bookmarks](/img/bookmarks.png)\n\n#### Customization\nYou can choose to use:\n* The Light or the Dark theme\n* The original ExploitDB database or the ExploitDB database with dates fix.\n\n![Light Theme](/img/light-theme.png)\n\n![Dark Theme](/img/dark-theme.png)\n\n\n## MINIMUM REQUIREMENTS\n\n### Supported OS\n\n* Linux\n* macOS\n* Windows (Preview)\n\n### Interpreter and tools\n\n* Python 3\n* SQLite 3\n* git\n* curl\n\n\n## INSTALLATION\n\n### Linux (non-root user) [recommended]\nIn order to install _HoundSploit_ we have to run the following commands:\n```sh\n$ git clone https://github.com/nicolas-carolo/houndsploit\n$ cd houndsploit\n$ ./install_db_linux.sh\n$ pip install -r requirements.txt\n$ python setup.py install\n```\nNow you can remove the repository of _HoundSploit_ you have downloaded, because this repository has been cloned in `~/.HoundSploit/houndsploit` for supporting automatic updates.\nIf you have already installed the version 2.1.0 of _hsploit_ or you never installed _hsploit_, you can check if there is the directory `~/HoundSploit` and then you can delete it.\n\n### Linux (root user)\nIn order to install _HoundSploit_ we have to run the following commands:\n```sh\n$ git clone https://github.com/nicolas-carolo/houndsploit\n$ cd houndsploit\n$ mkdir /root/.HoundSploit\n$ touch /root/.HoundSploit/enable_root.cfg\n$ ./install_db_linux.sh\n$ pip install -r requirements.txt\n$ python setup.py install\n```\nNow you can remove the repository of _HoundSploit_ you have downloaded, because this repository has been cloned in `~/.HoundSploit/houndsploit` for supporting automatic updates.\nIf you have already installed the version 2.1.0 of _hsploit_ or you never installed _hsploit_, you can check if there is the directory `~/HoundSploit` and then you can delete it.\n\n### macOS\nIn order to install _HoundSploit_ we have to run the following commands:\n```sh\n$ git clone https://github.com/nicolas-carolo/houndsploit\n$ cd houndsploit\n$ ./install_db_darwin.sh\n$ pip3 install -r requirements.txt\n$ python3 setup.py install\n```\nNow you can remove the repository of _HoundSploit_ you have downloaded, because this repository has been cloned in `~/.HoundSploit/houndsploit` for supporting automatic updates.\nIf you have already installed the version 2.1.0 of _hsploit_ or you never installed _hsploit_, you can check if there is the directory `~/HoundSploit` and then you can delete it.\n\n### Windows (Preview)\nBefore proceding with the installation, be sure that you have installed Python from the [official site](https://www.python.org/downloads/) and not from the Windows Store\nRun a _PowerShell_ session as _Administrator_\n```powershell\nPS\u003e git clone https://github.com/nicolas-carolo/houndsploit\nPS\u003e cd houndsploit\nPS\u003e powershell.exe -ExecutionPolicy Bypass -File .\\install_db_windows.ps1\nPS\u003e pip install -r requirements.txt\nPS\u003e python setup.py install\n```\nNow you can remove the repository of _HoundSploit_ you have downloaded, because this repository has been cloned in `~\\.HoundSploit\\houndsploit` for supporting automatic updates.\n\n### Troubleshooting\nIf you encounter problems during the installation phase, please run:\n```sh\n$ rm -fr ~/.HoundSploit\n```\nand then repeat the installation phase.\n\n\n## USAGE\n1. Run _HoundSploit_ server:\n   ```sh\n   $ houndsploit\n   ```\n2. Go to `http://localhost:5000`\n\n## COPYRIGHT\n\nCopyright © 2021, Nicolas Carolo.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n1. Redistributions of source code must retain the above copyright\n   notice, this list of conditions, and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright\n   notice, this list of conditions, and the following disclaimer in the\n   documentation and/or other materials provided with the distribution.\n\n3. Neither the name of the author of this software nor the names of\n   contributors to this software may be used to endorse or promote\n   products derived from this software without specific prior written\n   consent.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT\nOWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolas-carolo%2Fhoundsploit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicolas-carolo%2Fhoundsploit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolas-carolo%2Fhoundsploit/lists"}