hivemind-websocket-protocol
August 10, 2026 ยท View on GitHub
WebSocket transport for HiveMind messages.
Overview
Provides a Tornado-based WebSocket server that connects hivemind-core's
listener protocol to network clients. Clients authenticate via a Base64
query-parameter and exchange HiveMessage frames over the socket.
Key Classes
| Class | Purpose | Source |
|---|---|---|
HiveMindWebsocketProtocol | NetworkProtocol plugin. Configures and starts the Tornado server | hivemind_websocket_protocol/__init__.py (HiveMindWebsocketProtocol) |
HiveMindTornadoWebSocket | Tornado WebSocketHandler. Handles auth, message dispatch, IP resolution | hivemind_websocket_protocol/__init__.py (HiveMindTornadoWebSocket) |
resolve_client_ip() | Resolves real client IP from forwarded headers when peer is a trusted proxy | hivemind_websocket_protocol/_client_ip.py |
parse_networks() | Parses CIDR strings into ipaddress network objects | hivemind_websocket_protocol/_client_ip.py |