What is hermes-wechat-relay?

This repository is a plugin for the Hermes Agent platform that allows WeChat messages to flow into Hermes as a standard input source, without touching Hermes' own internal code or its built-in WeChat connection. Hermes is an AI agent platform, and this plugin registers a separate channel called wechat_relay that sits alongside the official one rather than replacing it. The plugin works by opening a small local web server on your computer at port 9797. An external relay bridge, which you provide separately, connects to this server and sends WeChat messages in as JSON events. The plugin translates those events into the format Hermes expects for incoming messages and routes outbound replies back through the same bridge connection. The README includes an optional Android app whose source code is in the repository, which can serve as that relay bridge by reading WeChat notifications and accessibility events on the phone and forwarding them to the plugin over a local network connection. The design is intentionally isolated. The plugin registers under a different name from the official Hermes WeChat adapter so the two can coexist in the same installation without interfering with each other. It is installed per-profile in your Hermes configuration folder rather than inside the Hermes source directory, which means Hermes updates and plugin updates can be handled independently without one overwriting the other. Features include group mention filtering so Hermes only responds when the bot is mentioned by name, stable logical chat IDs to track conversations even when display names change, a simple allowlist for controlling which chats the plugin processes, and optional message archiving. Installation involves copying three files into your Hermes profile's plugin folder and adding a configuration block to the profile's config file. The README includes security notes about binding the server to localhost only, using a shared secret for any non-local traffic, and not exposing the port publicly. The project is MIT licensed.