gptree-pentestgpt-bridge 0.2.0

WebSocket bridge connecting local PentestGPT to GPTree

GPTree PentestGPT Bridge

WebSocket bridge that connects your local PentestGPT installation to GPTree. The bridge runs on your machine and connects outbound only. No exposed ports, no inbound firewall rules.

Quick Start

1. Generate a token

Go to GPTree > Settings > PentestGPT and click Generate Token.

2. Install

pip install gptree-pentestgpt-bridge

3. Run

export GPTREE_TOKEN=pt_your_token_here

pentestgpt-bridge

The bridge auto-fetches connection details from GPTree using your token. No additional configuration is needed.

Optional: Install PentestGPT SDK

Without the PentestGPT SDK, the bridge runs in stub mode (returns sample responses so you can verify the connection works). Install the SDK for real pentesting:

pip install pentestgpt

Environment Variables

Variable	Default	Description
GPTREE_URL	https://gp-tree.com	GPTree server URL (only change for self-hosted instances)
GPTREE_TOKEN	(required)	Bridge token from GPTree settings
PENTESTGPT_MAX_ITERATIONS	300	Max agent iterations per request
PENTESTGPT_WORKSPACE	./workspace	Working directory for tool output

How It Works

1. The bridge authenticates with GPTree using your token
2. GPTree returns WebSocket connection details automatically
3. The bridge subscribes to your private channel via WebSocket
4. When you send a message in GPTree using a PentestGPT model, the bridge receives the work
5. PentestGPT runs locally, streaming results back to GPTree in real time
6. Findings (vulnerabilities, open ports, etc.) are cataloged automatically

Requirements

• Python 3.10 or later
• A GPTree account with PentestGPT enabled
• (Optional) PentestGPT SDK for real scanning capabilities