Skip to content
Wallbreaker Hermes

Installation and setup

Requirements

Section titled “Requirements”
  • Python 3.11 or newer.
  • Git for development checkouts and optional library updates.
  • Node.js only for dashboard development, the P4RS3LT0NGV3 bridge, or this documentation site.
  • Explicit authorization for every target.

Install the release

Section titled “Install the release”
Terminal window
python -m pip install wallbreaker-hermes==0.3.1
wallbreaker --help
wallbreaker check

The distribution is named wallbreaker-hermes. The import package and commands remain wallbreaker and wb for upstream compatibility.

Install for development

Section titled “Install for development”
Terminal window
git clone https://github.com/Yivas/wallbreaker-hermes.git
cd wallbreaker-hermes
python -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[dev]"
pytest -q

On Windows PowerShell, activate with:

Terminal window
.\.venv\Scripts\Activate.ps1

Dashboard contributors use the lockfile rather than updating dependencies during setup:

Terminal window
python -m pip install -e ".[dev,dashboard]"
cd wallbreaker/dashboard/web
npm ci
npm test -- --run
npm run build

Verify the checkout

Section titled “Verify the checkout”
Terminal window
wallbreaker check
python -m ruff check .
pytest -q

The default suite must not require provider credentials or run a live campaign.