NousResearch/hermes-agent · error · Error

Hermes gateway unavailable

Error message

Hermes gateway unavailable

What it means

Error "Hermes gateway unavailable" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/app/gateway/hooks/use-gateway-request.ts:111

        connectionRef.current = null
        setConnection(null)

        return null
      } finally {
        reconnectingRef.current = null
      }
    })()

    return reconnectingRef.current
  }, [])

  const requestGateway = useCallback(
    async <T>(method: string, params: Record<string, unknown> = {}, timeoutMs?: number, signal?: AbortSignal) => {
      const gateway = gatewayRef.current

      if (!gateway) {
        throw new Error('Hermes gateway unavailable')
      }

      try {
        return await gateway.request<T>(method, params, timeoutMs, signal)
      } catch (error) {
        const message = error instanceof Error ? error.message : String(error)

        if (!/not connected|connection closed/i.test(message)) {
          throw error
        }

        // Primary keeps the OAuth-aware reconnect (remote gateways re-mint a
        // single-use ticket); background profiles are always local pool
        // backends, so the registry handles their reconnect with no reauth.
        const recovered = isActivePrimary() ? await ensureGatewayOpen() : await ensureActiveGatewayOpen()

        if (!recovered) {
          // Prefer the reauth error from the failed reconnect (OAuth session

View on GitHub (pinned to c896c09c42)

Solutions

1. Confirm the Hermes backend is running and reachable (Settings → Gateway).
2. Reconnect or restart the backend, then retry the request.
3. Check network/proxy/firewall between the desktop app and the gateway.

When it happens

Trigger: Thrown at apps/desktop/src/app/gateway/hooks/use-gateway-request.ts:111 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/cdf65ef66ad9df5d. Report an issue: GitHub.