Installation

WSHawk v4.0.4 is available as a Python package and as two separately packaged desktop editions.

Python CLI

python -m pip install --upgrade wshawk

# Optional browser-assisted XSS evidence
python -m pip install --upgrade "wshawk[browser]"
playwright install chromium

Confirm the installed version:

wshawk --version
wshawk-advanced --version
wshawk-defensive --version

Desktop Downloads

Choose the edition whose architecture you want to use:

Edition	Backend	Release
WSHawk desktop	Electron + Python sidecar	v4.0.4
WSHawk Electron + Go	Electron + private Go worker	electron-go-v4.0.4

Both releases provide platform-specific packages for Windows, Linux, and macOS. Download the checksum file from the same release and verify the package before installation.

Docker

docker pull rothackers/wshawk

Docker is useful for the CLI and reproducible lab workflows. The native desktop packages provide the full Electron interfaces.

Source Checkout

git clone https://github.com/regaan/wshawk.git
cd wshawk
python -m pip install -e ".[browser]"
playwright install chromium

Use only targets you own or are explicitly authorized to assess.