Installation and Build

Install Surfaces

WSHawk currently makes the most sense in four install shapes:

• desktop release assets from GitHub Releases
• pip install wshawk
• source build from the main repository
• Docker for isolated CLI-style execution

pip Install

pip install wshawk
playwright install chromium

Useful entry points:

• wshawk
• wshawk-interactive
• wshawk-advanced
• wshawk-defensive

Desktop from Source

git clone https://github.com/regaan/wshawk
cd wshawk
git status
pip install -e .
cd desktop
npm install
npm run smoke
npm start

Docker

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

Docker is useful for the compatibility CLI path. It is not the main v4 desktop experience.

Smoke Check

The desktop smoke check is the lightweight sanity run for the Electron shell and bridge startup:

cd desktop
npm run smoke