hermes-feishu: messaging bridge for Hermes Agent

Hermes Agent plugin that sends Feishu card messages and renders Markdown tables in Feishu chats

What hermes-feishu does

The built-in Feishu channel in Hermes sends Markdown as a post message with an md tag, but Feishu's Markdown component supports only a subset of syntax and does not render tables, so tables generated by the model arrive broken. This plugin adds two tools. send_feishu_card detects Markdown tables and converts them into a Feishu card Table component, with optional title, template color, chat_id and emoji reaction. send_feishu_table sends structured headers and rows directly. A pre_llm_call hook injects formatting instructions when the platform is Feishu.

FEISHU_APP_ID and FEISHU_APP_SECRET must be set in ~/.hermes/.env, or the tools do not load. The README documents a known issue: Hermes does not pass chat_id to the pre_llm_call hook, so for single-chat setups you can set HERMES_FEISHU_CHAT_ID as a fallback. The app needs the im:message and im:message:readonly permissions. The README is written in Chinese.

Key features

send_feishu_card tool that turns Markdown tables into Feishu card Table components
send_feishu_table tool for structured headers and rows
pre_llm_call hook that adds Feishu formatting instructions
Optional emoji reaction after a message is sent
HERMES_FEISHU_CHAT_ID fallback when chat_id is not passed

When to use it

Getting comparison tables from Hermes to display correctly in Feishu
Sending status reports as colored card messages
Running Hermes in a single Feishu group chat with a fixed default chat

Who it is for: Hermes Agent users who run the agent through Feishu and need tables and cards to display properly.

How it fits with Hermes Agent

Built for Hermes Agent as a plugin that extends its Feishu messaging channel.

How to install hermes-feishu

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

hermes plugins install arkseek/hermes-feishu
hermes gateway restart

Requirements: Python 3.10+, Hermes Agent with the Feishu platform configured, and a Feishu Open Platform app with App ID and App Secret

FAQ

What is hermes-feishu?

hermes-feishu is a Hermes Agent plugin that adds card messages and table rendering to the Feishu channel, so Markdown tables from the model display correctly.

How do I install hermes-feishu?

Run hermes plugins install arkseek/hermes-feishu, put FEISHU_APP_ID and FEISHU_APP_SECRET in ~/.hermes/.env, and restart with hermes gateway restart. The README warns that the plugin tools do not load unless the credentials are in that file.

Is hermes-feishu free and open source?

The README text says MIT License, but the repository has no license file that GitHub detects. Default copyright may apply, so check with the author before reuse.