Zulip Plugin for Hermes: messaging bridge for Hermes Agent

Hermes gateway adapter that makes the agent a threaded teammate in Zulip streams and DMs

What Zulip Plugin for Hermes does

Zulip Plugin for Hermes adds Zulip as a platform in the Hermes gateway. The agent answers in streams and direct messages with topic threading and traffic policies. Choosing the recommended setup turns on mention-gated streams, DMs for the bot's Zulip owner only, an activity trace, on-demand history, per-session queueing, per-topic sessions and reaction triggers. The README also documents slash commands, exec approvals, sticky engagement, stream watching and file sending.

A Zulip generic bot is required, subscribed to the streams it should answer in, and its email, API key and site URL go in ~/.hermes/.env. Running hermes gateway setup prompts for each value, and answering yes to the recommended setup writes a single ZULIP_PROFILE=recommended line. The plugin has over 50 settings but a fresh install needs none of them. It is 28 modules, so the whole repository must be installed. A sibling project, openclaw-zulip-bridge, does the same job for OpenClaw in TypeScript.

Key features

Zulip streams and private messages through the Hermes gateway
Topic threading with a separate session per topic
Mention-gated streams and owner-only DMs in the recommended profile
Progressive activity trace, on-demand history and per-session queue
Exec approvals, slash commands and file sending
One-question gateway setup that writes ZULIP_PROFILE=recommended

When to use it

Adding an AI teammate to a self-hosted Zulip workspace without moving to another chat vendor
Letting a team talk to Hermes in topic-based threads
Approving agent exec requests from inside the chat

Who it is for: Teams on Zulip who want a self-hosted Hermes Agent as a participant in their threaded chat.

How it fits with Hermes Agent

Built for Hermes Agent as a gateway adapter plugin, installed under ~/.hermes/plugins and enabled with hermes plugins enable zulip.

How to install Zulip Plugin for Hermes

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

pip install "zulip>=0.9.0"
git clone https://github.com/niyazmft/zulip-hermes-integration.git ~/.hermes/plugins/zulip
hermes plugins enable zulip
hermes gateway

Requirements: Hermes 0.18.2+ (0.21.3+ for native exec-approval buttons), Python 3.10+, and a Zulip generic bot with its email, API key and site URL

FAQ

What is Zulip Plugin for Hermes?

Zulip Plugin for Hermes is a gateway adapter that lets Hermes Agent work in Zulip streams and private messages. It supports topic threading, traffic policies and an activity trace.

How do I install Zulip Plugin for Hermes?

Install the zulip Python package into the same environment as Hermes, clone the repository into ~/.hermes/plugins/zulip, and run hermes plugins enable zulip. Then add the bot credentials to ~/.hermes/.env, enable the zulip platform in config.yaml and start hermes gateway.

What do I need to run Zulip Plugin for Hermes?

You need Hermes 0.18.2 or newer (0.21.3 or newer for native exec-approval buttons), Python 3.10 or newer, and a Zulip generic bot. The bot must be subscribed to the streams it should answer in.