Skip to content

buffer/thug

Folders and files

NameName
Last commit message
Last commit date

Latest commit

45cc3ab · Mar 18, 2025
Jan 9, 2025
Feb 26, 2025
Jan 9, 2025
Feb 26, 2025
Feb 19, 2025
Jan 16, 2024
Jun 25, 2020
Aug 8, 2023
Apr 21, 2022
Oct 19, 2024
Jul 27, 2020
Jan 19, 2024
Nov 7, 2024
Feb 6, 2024
Sep 14, 2016
Jan 3, 2023
Feb 19, 2025
Mar 18, 2025
Nov 7, 2024

Repository files navigation

Thug

version badge github badge codefactor badge codecov badge bandit badge

The number of client-side attacks has grown significantly in the past few years shifting focus on poorly protected vulnerable clients. Just as the most known honeypot technologies enable research into server-side attacks, honeyclients allow the study of client-side attacks.

A complement to honeypots, a honeyclient is a tool designed to mimic the behavior of a user-driven network client application, such as a web browser, and be exploited by an attacker's content.

Thug is a Python low-interaction honeyclient aimed at mimicking the behavior of a web browser in order to detect and emulate malicious contents.

Documentation

docs badge

Documentation about Thug installation and usage can be found at http://thug-honeyclient.readthedocs.io/.

Contributions

donate badge

Thug is open source and we welcome contributions in all forms!

Thug is free to use for any purpose (even commercial ones). If you use and appreciate Thug, please consider supporting the project with a donation using Paypal.

Testing

To run the full test suite using tox, run the command:

tox

Since tox builds and installs dependencies from scratch, using pytest for faster testing is recommended:

pytest --cov thug

License information

Copyright (C) 2011-2025 Angelo Dell'Aera <angelo.dellaera@honeynet.org>

License: GNU General Public License, version 2