Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



78 Commits

Repository files navigation


Polymorph is a tool that facilitates the modification of network traffic on the fly by allowing the execution of Python code on network packets that are intercepted in real time.

This framework can be used to modify in real time network packets that implement any publicly specified network protocol. Additionally, it can be used to modify privately specified network protocols by creating custom abstractions and fields.


Polymorph is specially designed to be installed and run on a Linux operating system. Before installing the framework, the following requirements must be installed:

sudo apt install build-essential python3-dev libnetfilter-queue-dev tshark tcpdump python3-pip wireshark git

After the installation of the dependencies, the framework itself can be installed with the Python pip package manager in the following way (to avoid errors, install Polymorph with the root user):

pip3 install git+
pip3 install polymorph

Using Polymorph

Below you can find some resources and practical examples with which you can learn how Polymorph works. I recommend that you read the articles in the following order:

  1. Setting up the enviroment
  2. Case Study. Part 1: How does Polymorph work? (Modifying ICMP on the fly)
  3. Case Study. Part 2: Global variables (Modifying ICMP on the fly)
  4. Case Study. Part 3: Structs (Modifying MQTT on the fly)
  5. Case study. Part 4: Creating custom layers and fields (Modifying MQTT on the fly)

Important Release Notes



This program is published with the aim of being used for educational purposes and to help improve the security of the systems. I am not responsible for the misuse of this project.