hermes-plugin-telegram-reactions

A Hermes Agent plugin that adds emoji reactions to Telegram messages. One tool call, one HTTP request, zero ceremony.

What it does

Adds a set_reaction tool that reads the current message's chat_id and message_id from the gateway's session environment variables. The agent just passes an emoji -- no need to figure out message IDs or chat IDs manually.

User: that's awesome!
Agent: [reacts with 🔥] Glad you liked it!

Install

pip (recommended)

pip install hermes-plugin-telegram-reactions

Restart Hermes and the tool appears automatically.

Manual (directory plugin)

mkdir -p ~/.hermes/plugins/telegram-reactions
# Copy the plugin files there:
cp hermes_plugin_telegram_reactions/__init__.py ~/.hermes/plugins/telegram-reactions/
cp hermes_plugin_telegram_reactions/tool.py ~/.hermes/plugins/telegram-reactions/

Requirements

• Hermes Agent with Telegram gateway configured and running
• aiohttp (included as a dependency)

The plugin only activates when a Telegram bot token is detected. It's invisible on CLI or other platforms.

How it works

No getUpdates, no message polling, no extra commands.

License

MIT