Configuration

Standalone / programmatic

from ovos_hivemind_solver import HiveMindSolver

solver = HiveMindSolver(config={
    "autoconnect": True,
    "useragent": "my-app",
    "lang": "en-us"
})

Via ovos-persona

{
  "name": "HiveMind",
  "solvers": [
    {
      "module": "ovos-solver-hivemind-plugin",
      "ovos-solver-hivemind-plugin": {
        "autoconnect": true,
        "lang": "en-us"
      }
    }
  ]
}

Key reference

Key	Type	Default	Description
autoconnect	bool	false	Connect automatically at construction time. If false, call solver.connect() before the first query.
useragent	string	"ovos-hivemind-solver"	User-agent string sent to the hub in the handshake.
websocket_ping_interval	number or null	10	Seconds between websocket keepalive pings. Hubs commonly drop idle clients ~15s after the last pong, so the default keeps the connection alive across slow queries. Set to 0 to disable (null falls back to the bus-client's own default interval).
websocket_ping_timeout	number or null	5	Seconds to wait for a pong before the client considers the connection dead. null falls back to the bus-client's own default.

Key	Type	Default	Description
site_id	string	from identity file	Site ID for the connection. Overrides the value in the identity file.
lang	string	"en-us"	Default language when no lang is present in the query context.

Connection identity

Host, port, access key, and password are read from the identity file at ~/.config/hivemind/_identity.json. Set it with:

hivemind-client set-identity \
  --key <access_key> \
  --password <password> \
  --host <hub_ip> --port 5678 --siteid solver

There is no way to pass credentials inline. The identity file is the only source.

---

← Solver integration · Home