Insurgent Framework

A framework for creating modular malware/bots to be used in training environments. Please take a look at the Wiki for usage details and development guidelines.

Priorites

1. Modularity
2. Capability
3. Compatability
4. Portability
5. Forensically Sound

Dependencies

• Python 2.7
• Pyinstaller
• Bottle

Other dependencies will be required by specific modules

Notes:

I had to modify pyinstaller to get it to recursively analyze dynamically imported modules' dependencies.

If not building pyinstaller from their Git repo, make sure you make the change manually:
https://github.com/pyinstaller/pyinstaller/commit/e9575e1145718ecc49625b782cee7cbb41d8522b

Installation

Unzip the contents of the package wherever you would like to run it from.

pip install pyinstaller
pip install bottle
(Other recommended dependencies)
pip install scapy

Usage

Build.py

python build.py -h

Translator.py

python translator.py -h

Base.py

It is not recommended to use base.py for testing purposes because most errors are likely to occur within the importing. However, if you are trying to test the module and don't want to worry about resolving pyinstaller import errors, you can run 'base.py'. Just make sure you settings.xml file is present in the root directory of the framework and has the same name as config.DEFAULT_CONFIG_FILE.