Skip to content

Getting Started

Requirements

  • Python 3.10+
  • A Kali backend exposing the kali-server-mcp REST API (default http://127.0.0.1:5000)
  • Ollama serving a supported model (default qcwind/qwen3-8b-instruct-Q4-K-M:latest on http://127.0.0.1:11434)

Installation

python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev,docs]"

Or build the distributable artifacts:

python -m build
pip install dist/hydrasight-*.whl

Docker

docker compose up --build

The image runs as a non-root user (hydra, uid 1000) and ships no offensive tooling — commands execute against the separate Kali bridge service. See Configuration for bind-mounted config and authorization files.

First engagement

  1. Start the Kali bridge and Ollama.
  2. Launch HydraSight:
hydrasight
  1. Authorize your target scope (nothing runs until you do):
hydra·sight › authorize 10.10.10.0/24

You will be prompted to type I AUTHORIZE exactly.

  1. Kick off an engagement:
hydra·sight › autopwn 10.10.10.15

See Usage for the full command reference.