Hermes Fry Cards: plugin for Hermes Agent

Hermes gateway plugin that streams Feishu and Lark replies as live interactive cards

What Hermes Fry Cards does

The plugin injects a hook into the Hermes gateway through AST-based injection, without changing Hermes core. Replies stream onto a Feishu card as they are generated, the header color follows state (blue while streaming, green when done, red on interruption or error), and thinking and tool calls are interleaved in true timeline order and collapsed into one bottom panel. The collapsed line shows the model, thought and tool counts, context percentage and elapsed time.

For stability it reflows over-limit tables into field lists, applies an 18 KB byte budget against Feishu's roughly 30 KB card limit, and seals a card and continues on a new one when it nears the 200-element limit. Remote markdown images are re-uploaded as Feishu img_key values. With modular Hermes 0.21 or newer, a group-chat safety boundary guards against leaking API keys and internal IPs. A standard-library web console called Studio edits the configuration, and a systemd user unit keeps it running. The README is in Chinese with an English version.

Key features

Streaming CardKit v2.0 cards with typewriter output
Thinking and tool calls in one collapsible panel
Markdown overflow handling and automatic card splitting
Remote images re-uploaded as Feishu img_key
Group-chat safety boundary on Hermes 0.21+
Studio web console and systemd user service

When to use it

Showing Hermes progress live in a Feishu or Lark chat
Keeping long tool-heavy replies from overflowing a Feishu card
Configuring card fields and model aliases through a web form

Who it is for: Teams that talk to Hermes Agent through Feishu or Lark.

How it fits with Hermes Agent

It is a Hermes gateway plugin that hooks the Feishu platform in the Hermes gateway and is restarted with hermes gateway restart.

How to install Hermes Fry Cards

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

curl -fsSL https://raw.githubusercontent.com/techysy/hermes-fry-cards/main/install.sh | bash
hermes gateway restart

Requirements: A Hermes Agent gateway and its Python virtual environment; the group-chat safety boundary needs modular Hermes 0.21+

Note: It works by injecting a hook into the Hermes gateway, so the gateway must be restarted after install and, for PyPI installs, re-injected after an upgrade when the injection template changes.

FAQ

What is Hermes Fry Cards?

It is a plugin for the Hermes gateway that renders replies as streaming Feishu or Lark cards, with a unified panel for reasoning and tool use.

Does Hermes Fry Cards work with Hermes Agent?

Yes, it is built for the Hermes Agent gateway. The installer finds Hermes' virtual environment, installs dependencies, checks compatibility and injects the hook, after which you restart the gateway.

How do I install Hermes Fry Cards?

Run the curl install script, then restart the gateway in a separate terminal with hermes gateway restart. A PyPI install and a source install are also described.