Install WSHawk v4.0.4

🪟

Windows

Classic or Electron + Go NSIS installer

🍎

macOS

Classic or Electron + Go DMG

🐧

Linux

Classic or Electron + Go AppImage, DEB, or archive

🐳

CLI / Docker

Compatibility and automation workflows

🖥️Desktop Application

Choose the backend and workflow you need. Both editions are version 4.0.4, install independently, and publish on separate GitHub release pages.

Classic

Electron + Python

Existing project services, CLI integration, browser companion, replay, race, evidence, and full web pentest workspace.

Download v4.0.4Bridge-free

Electron + Go

Private Go worker, authorization matrices, object discovery, safe writes, encrypted evidence, findings, and retesting.

Download Electron + Go v4.0.4

Desktop smoke check from source

# Classic Electron + Python
git clone https://github.com/regaan/wshawk
cd wshawk/desktop
npm install
npm run smoke

# Electron + Go
cd ../electron-desktop
npm ci
npm run build:go
npm start

Note: npm run smoke is the lightweight desktop sanity check, not the heavier full headless path.

⚡CLI via pip

The CLI still works well for a first pass, scripting, and compatibility workflows.

PyPI install

pip install wshawk

# Optional browser runtime for evidence collection
playwright install chromium

# Basic compatibility scan
wshawk ws://target.example/ws

# Interactive and advanced entry points
wshawk-interactive
wshawk-advanced ws://target.example/ws
wshawk-defensive

🧰Build from Source

Use source builds for development, validation labs, and changes to either desktop edition.

Repository setup

git clone https://github.com/regaan/wshawk
cd wshawk
pip install -e .

# Optional validation check
./venv/bin/python validation/run_validation.py

# Start Classic desktop from source
cd desktop
npm install
npm start

# Or start Electron + Go
cd ../electron-desktop
npm ci
npm run build:go
npm start

# Run the scored authorization benchmark
npm run test:authorization-benchmark

🐳Docker

Docker is useful for isolated CLI-style execution. It is not the primary v4 desktop workflow.

Container quick start

docker pull rothackers/wshawk:latest

docker run --rm rothackers/wshawk ws://target.example/ws

📋Quick Reference

Method	Command / Action	Best For
Classic Desktop	v4.0.4 release	Established Python services, CLI integration, browser pairing, and web pentest workflow
Electron + Go	Electron + Go release	Bridge-free native worker, authorization matrix, protected evidence, findings, and retesting
pip	`pip install wshawk`	Compatibility CLI, scripting, quick first pass
Source	`git clone https://github.com/regaan/wshawk`	Desktop development, labs, validation, smoke checks
Docker	`docker pull rothackers/wshawk:latest`	Isolated CLI-style execution