NousResearch/hermes-agent · error

Hermes gateway is not connected

Error message

Hermes gateway is not connected

What it means

Error "Hermes gateway is not connected" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/store/projects.ts:338

    if (projectId !== $projectScope.get()) {
      enterProject(projectId)
    }
  }
}

// Issue a request on whichever gateway is currently active, reconnecting once
// if the socket dropped. Projects are per-profile, so they intentionally follow
// the active gateway just like the session list does.
async function gatewayRequest<T>(method: string, params: Record<string, unknown> = {}): Promise<T> {
  let gateway = activeGateway()

  if (!gateway || gateway.connectionState !== 'open') {
    gateway = await ensureActiveGatewayOpen()
  }

  if (!gateway) {
    throw new Error('Hermes gateway is not connected')
  }

  return gateway.request<T>(method, params)
}

async function gatewayRequestOn<T>(
  gateway: HermesGateway,
  method: string,
  params: Record<string, unknown> = {}
): Promise<T> {
  return gateway.request<T>(method, params)
}

interface ActiveProjectsContext {
  gateway: HermesGateway
  profile: string
}

View on GitHub (pinned to c896c09c42)

Solutions

1. Connect to the Hermes gateway before managing projects.
2. Restart or reconnect the backend from Settings → Gateway, then retry.

When it happens

Trigger: Thrown at apps/desktop/src/store/projects.ts:338 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/421d68a9f2eeccf8. Report an issue: GitHub.