Hermes Agent for Obsidian: app and UI for Hermes Agent

Obsidian plugin that chats with a local Hermes Agent gateway in a multi-tab sidebar

What Hermes Agent for Obsidian does

Hermes Agent for Obsidian is a plugin that lets you chat with a locally installed Hermes Agent from a multi-tab sidebar in Obsidian. It sends the current note or selected text as context and streams replies into the panel. The README states it is a separate plugin from Claudian and does not modify or replace it.

The plugin talks to the local Hermes gateway over HTTP, by default at http://127.0.0.1:8642. It checks GET /v1/capabilities and uses the Runs transport (POST /v1/runs with an event stream) when available, which surfaces tool, reasoning and usage events, and otherwise falls back to OpenAI-compatible Chat Completions. Authentication is a Bearer key, API_SERVER_KEY, pasted into the plugin settings. The gateway can be started by Hermes Desktop or by running hermes gateway from the command line.

Key features

Multi-tab chat sidebar inside Obsidian
Sends the current note or selected text as context
Streams replies from the Hermes gateway
Uses the Runs transport for tool, reasoning and usage events, with a Chat Completions fallback
Test connection button in the plugin settings
Works with a gateway started by Hermes Desktop or by hermes gateway

When to use it

Asking Hermes questions about the note you are editing
Summarizing or rewriting selected text with the agent
Using a Hermes Agent running on the same machine without leaving Obsidian

Who it is for: Obsidian users who already run Hermes Agent locally and want to chat with it from their vault.

How it fits with Hermes Agent

It is built for Hermes Agent and talks to the Hermes gateway HTTP API, mirroring the transport logic of Hermes Desktop's own client.

How to install Hermes Agent for Obsidian

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npm install
npm run build

Requirements: The Hermes gateway HTTP API reachable (default http://127.0.0.1:8642) with API_SERVER_KEY set

FAQ

What is Hermes Agent for Obsidian?

It is an Obsidian plugin that chats with a locally installed Hermes Agent through the Hermes gateway HTTP API. Replies stream into a multi-tab sidebar and the current note can be sent as context.

Does Hermes Agent for Obsidian need Hermes Desktop?

No. It needs the gateway API to be reachable, which Hermes Desktop starts or which you can start with hermes gateway after enabling the api_server platform in ~/.hermes/config.yaml.

What do I need to run Hermes Agent for Obsidian?

You need a reachable Hermes gateway, by default at http://127.0.0.1:8642, and its API_SERVER_KEY pasted into the plugin settings. To build from source, run npm install and npm run build.