installation guide

---

Installation Guide

Prerequisites

• Python 3.8 or higher
• pip package manager
• Wine (for Windows payload generation)
• Git

Automated Setup

Quick Installation (Recommended)

git clone https://github.com/HackScaleTeam/kush-exploitation-framework.git
cd kush-exploitation-framework
chmod +x setup.sh
./setup.sh
pip3 install -r requirements.txt

The setup script will:

• Install system dependencies

• Set up Wine environment

• Install Windows Python in Wine

• Configure PyInstaller for cross-compilation

Manual Installation

1. Install Python Dependencies

pip3 install colorama mss requests pillow

2. Wine Setup (for Windows Payloads)

• Ubuntu/Debian:

sudo apt update
sudo apt install wine winetricks

Install Python in Wine:

Download Windows Python

wget https://www.python.org/ftp/python/3.11.8/python-3.11.8-amd64.exe

wine python-3.11.8-amd64.exe /quiet InstallAllUsers=1 PrependPath=1

Install PyInstaller in Wine

wine pip install pyinstaller

3. Verify Installation

Check Python installation

python3 --version

Check Wine installation

wine --version

Verify dependencies

python3 -c "import colorama, mss, requests, PIL; print('Dependencies OK')"

Platform-Specific Notes

• Linux Systems
• Most distributions work out of the box
• Ensure python3 and pip3 are available
• Wine may require 32-bit libraries on 64-bit systems

macOS Systems

Install Wine via Homebrew:

 brew install wine

• May require Xcode command line tools

Windows Systems

• Use native Python instead of Wine

• Builder will use local PyInstaller

• Ensure Python is added to PATH

Testing the Setup

Test basic functionality

python3 listener.py --help

python3 builder.py --help

Verify file compilation

python3 -m py_compile backdoor.py listener.py builder.py