Hermes Feishu Streaming Card for Hermes Agent

Plugin that turns Hermes Gateway replies in Feishu or Lark into live-updating interactive cards

What Hermes Feishu Streaming Card does

HFC shows what Hermes is doing as it happens: the current tool action, the process log and the answer, with distinct states for running, waiting, failed and complete. When Hermes needs an approval or clarification, the card offers buttons or a form, and later output continues in a follow-up card that keeps the earlier text and the action receipt. Replies support Markdown, code and tables, and the body is separated from thinking and tool steps.

It works in direct chats, group chats and topics, with multi-bot and multi-profile setups, and specific chats can use native messages instead. The /model command uses the same provider and model list as the Hermes CLI, and /resume selects earlier sessions. The footer can show model, duration, tokens and context use, depending on what Hermes provides. The package includes status, doctor and repair commands, and by default runs as a sidecar service on 127.0.0.1:8765. The README documents release v4.7.4.

Key features

Live card with current tool action, process log and final answer
Button or form approvals and clarifications
Continuation card after an approval, keeping earlier output
Direct, group and topic chats with multi-bot and multi-profile support
Provider-then-model picker for /model, plus /resume
status, doctor and recovery commands

When to use it

Following a long Hermes task from a Feishu chat
Approving a risky command from a card button
Running several Hermes profiles or bots in one Feishu workspace

Who it is for: Hermes Agent users who talk to their agent through Feishu or Lark.

How it fits with Hermes Agent

Built for Hermes Agent Gateway as a Feishu and Lark add-on, installed into the environment Hermes uses.

How to install Hermes Feishu Streaming Card

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/baileyh8/hermes-feishu-streaming-card/main/install.sh | bash
irm https://raw.githubusercontent.com/baileyh8/hermes-feishu-streaming-card/main/install.ps1 | iex

Requirements: An installed Hermes Agent, Python 3.9+, and a Feishu or Lark bot connected to Hermes with its App ID and App Secret

FAQ

What is Hermes Feishu Streaming Card?

Hermes Feishu Streaming Card is a plugin that turns Hermes Agent Gateway replies in Feishu or Lark into live-updating interactive cards. The cards show tool actions, accept approvals and end with the full answer.

How do I install Hermes Feishu Streaming Card?

On macOS or Linux, run the curl install.sh command shown in the README. On Windows, run the PowerShell install.ps1 command. The script installs into the environment Hermes uses, writes credentials to a local .env, installs a hook and starts the sidecar.

What do I need to run Hermes Feishu Streaming Card?

You need an installed Hermes Agent, Python 3.9 or newer, and a Feishu or Lark bot already connected to Hermes with an App ID and App Secret. Streaming must also be enabled in the Hermes configuration.