NousResearch/hermes-agent · error

Gateway not connected

Error message

Gateway not connected

What it means

Error "Gateway not connected" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/lib/oneshot.ts:41

  maxTokens?: number
  temperature?: number
  /**
   * Session whose model to inherit. Defaults to the active session so output
   * matches the model the user is coding with; pass null to force the
   * configured auxiliary backend instead.
   */
  sessionId?: string | null
}

/**
 * Send a one-off request to Hermes and return the generated text.
 * Throws when the gateway is offline or the backend reports an error.
 */
export async function requestOneShot(req: OneShotRequest): Promise<string> {
  const gateway = $gateway.get()

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

  const sessionId = req.sessionId === undefined ? $activeSessionId.get() : req.sessionId

  const result = await gateway.request<{ text?: string }>('llm.oneshot', {
    input: req.input,
    instructions: req.instructions,
    max_tokens: req.maxTokens,
    session_id: sessionId ?? undefined,
    task: req.task,
    temperature: req.temperature,
    template: req.template,
    variables: req.variables
  })

  return (result?.text ?? '').trim()
}

View on GitHub (pinned to c896c09c42)

Solutions

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

When it happens

Trigger: Thrown at apps/desktop/src/lib/oneshot.ts:41 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/cca350e2ad3d200f. Report an issue: GitHub.