WebScanner Installation - capstone-hermes/hermes-fullstack GitHub Wiki

⚙️ Installation Guide – Hermes Web Scanner

This short guide shows how to set up and use the Python-based web-scanner locally.

✅ Prerequisites

Tool Version Notes
Python 3.10 or newer Tested on CPython 3.10/3.11
pip latest Comes with Python
Chromium / Google Chrome any modern release Headless mode is required by Pyppeteer.
(skip this if you plan to use the Docker image)

Linux only: Make sure common Chrome dependencies are installed (e.g. libnss3, libatk1.0-0, fonts-liberation, …).

📥 Installation Steps

  1. Clone the repository

    git clone [https://github.com/yourusername/hermes-fullstack.git](https://github.com/yourusername/hermes-fullstack.git)
cd hermes-fullstack/web-scanner

  2. Create and activate a virtual-environment (recommended)

    python -m venv venv
source venv/bin/activate        # Linux/macOS
# For Windows use: venv\Scripts\activate

  3. Install Python dependencies

    pip install -r requirements.txt

  4. Set the Chrome/Chromium path (if needed) Edit src/constants.py and update BROWSER_EXECUTABLE_PATH if Chrome/Chromium is not in a standard system PATH location.

▶️ Run a Scan (development mode)

python -m src.main --url [https://target.example.com](https://target.example.com)
⚠️ **GitHub.com Fallback** ⚠️