How to use Hermes Agent in BoltAI

Written By Daniel Nguyen

Last updated About 4 hours ago

Hermes Agent gives you a local, tool-enabled AI assistant that exposes an OpenAI-compatible API BoltAI can connect to.

Follow these quick steps to use Hermes Agent inside BoltAI.

Install & run Hermes Agent


Install Hermes Agent and start the local server. If you already have Hermes Agent installed, make sure it is running and listening on the default API port.

Hermes Agent’s OpenAI-compatible API server is disabled by default. Follow the official Hermes guide to enable it:

Hermes Agent API Server Guide

By default, BoltAI expects Hermes Agent at http://127.0.0.1:8642/v1

If you changed the port or host in Hermes Agent, use that address instead.

Add Hermes Agent in BoltAI


Hermes Agent is now ready. Let’s configure it in BoltAI.

  • Open BoltAI → Settings → AI Services.

  • Click Add → choose Hermes Agent → Next.

  • Enter the Base URL and optionally the API Key if you set one.

  • Set a Default Model → Add Service.

Start a new chat with Hermes Agent

Hermes Agent in BoltAI

  • Click New Chat.

  • Choose the Hermes Agent service/model in the model switcher.

  • Start chatting.

Quick checks (if it doesn’t connect)

  • Hermes Agent API server is enabled

  • Hermes Agent is running

  • The Base URL in BoltAI matches the Hermes API address

  • The model you want to use is available in Hermes Agent

  • If your Hermes setup uses auth, the API key in BoltAI matches it