aiduPOP: messaging bridge for Hermes Agent

Feishu/Lark streaming card plugin for Hermes Agent with live thinking panels and clarify cards

What aiduPOP does

aiduPOP renders Hermes Agent replies in Feishu (Lark) as streaming Cardkit 2.0 cards that appear from the first token, with no typing indicator. The answer sits on top and a panel below shows the model name, thinking rounds, tool calls, timestamps and duration, expandable for the full trace. Status is color coded: green for finished, red for aborted and yellow for an error. When the agent needs clarification, an interactive option card appears in the chat and the selection is passed back to the agent.

The project began from Aowen-Nowor/hermes-lark-streaming v1.6.0 and is an independent project rather than a fork mirror. It adds a themed visual layer, a visual configuration workshop started with aidupop studio, and atomic rollback and card rebuild retries so failures do not fall back to plain text. Panel and body font sizes can be set per role and per device in the hermes_lark_streaming section of config.yaml. It is distributed from GitHub and Gitee as a Hermes plugin, and no longer through PyPI or GHCR.

Key features

Streaming Feishu cards from the first token
Expandable panel with thinking rounds, tool calls and timestamps
Green, red and yellow status colors for finished, aborted and error
Interactive clarify option cards with a callback to the agent
aidupop studio visual configuration workshop
Separate font sizes for PC and mobile

When to use it

Reading an agent's reasoning and tool calls live inside Feishu
Answering a clarify question from a card instead of typing a reply
Tuning card appearance for desktop and phone clients

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

How it fits with Hermes Agent

Built for Hermes Agent: it is a directory plugin placed in ~/.hermes/plugins/ that hooks into the gateway platform registry.

How to install aiduPOP

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

git clone https://github.com/monkey2jack/aiduPOP.git
cp -r aiduPOP ~/.hermes/plugins/hermes-lark-streaming
hermes gateway restart

Requirements: Hermes Agent installed, a configured Feishu (Lark) bot, and Python 3.11+

Note: It builds on hermes-lark-streaming v1.6.0 and is no longer published to PyPI or GHCR, so it is installed from GitHub or Gitee.

FAQ

What is aiduPOP?

aiduPOP is a Hermes Agent plugin that shows answers and thinking in Feishu (Lark) as streaming cards, with an expandable trace panel, status colors and interactive clarify cards.

Does aiduPOP work with Hermes Agent?

Yes. It is built for Hermes Agent and loads as a plugin through the gateway. The setup copies it into ~/.hermes/plugins/hermes-lark-streaming and restarts the gateway.

What do I need to run aiduPOP?

You need Hermes Agent installed, a configured Feishu (Lark) bot, and Python 3.11 or newer.