Skip to main content

Built a Hermes Agent gateway plugin for BoltAI — full markdown + slash commands

Hey,


I've been using BoltAI v2 with Hermes Agent (https://github.com/NousResearch/hermes-agent) and hit two annoyances with the official OpenAI-compatible gateway:

  1. Markdown gets flattened — headers, tables, code blocks all come through as plain text

  2. Hermes slash commands (/help, /status, /new, /model, etc.) aren't intercepted, so they get sent to the LLM instead of running locally and therefore they dont work properly as AI agent cant work with some directly…


So I built a small hermes drop-in plugin that fixes both. It's a separate gateway adapter (subclasses the official one, doesn't fork it), runs on its own port, and lives here:

https://github.com/Dworf/boltai-hermes-gateway


Install:

hermes plugins install Dworf/boltai-hermes-gateway --enable


Then in BoltAI just follow the official Hermes setup guide (https://help.boltai.com/en/help/articles/9536908-how-to-use-hermes-agent-in-boltai) but point it at port 8643 instead of 8642. Full markdown renders correctly, slash commands work as expected, streaming is preserved.


Should also work with any other OpenAI-compatible client that supports markdown + streaming (TypingMind, OpenWebUI, LibreChat, etc.) — untested though (and yeah BoltAI has no competition in this space :) )


Question for the BoltAI team / community: if there's interest, I'm happy to implement a commands discovery endpoint on the plugin side so that — if BoltAI ever wants to add it on the client side — you could get interactive slash command suggestions, autocomplete, and /-menu UX natively. Let me know if that's something worth building toward. Should be easy from the plugin side…


Thanks!

2 comments

Log in to comment and vote

Comments2

  • Inspired Earth

    •

    May 13

    This look fascinating. Checking it out. Thanks for sharing.

  • David

    •

    May 8

    and this is how it looks….