Hermes Max Platform: messaging bridge for Hermes Agent

Hermes Agent gateway plugin that connects Hermes to the Max messenger through a webhook

What Hermes Max Platform does

Hermes Max Platform Plugin connects Hermes Agent to Max, a messenger, as a gateway channel: you write to your Max bot and Hermes answers. The plugin runs a local HTTP server on port 8646 at /max/webhook, converts each Max update into a Hermes MessageEvent and sends replies back through the Max platform API with Markdown formatting. Max requires a public HTTPS webhook URL, so the README suggests Cloudflare Tunnel or ngrok for testing.

The repository was prepared for a workshop. A participant installs Hermes, gives the agent the repository link and asks it to connect Max, and the repo includes an AGENTS.md written for AI agents next to the human instructions. Configuration uses MAX_BOT_TOKEN, plus optional MAX_WEBHOOK_SECRET, MAX_ALLOWED_USERS and MAX_HOME_CHANNEL for cron and send_message delivery. The README is in Russian and links the official dev.max.ru documentation for creating a bot.

Key features

Max messenger as a Hermes gateway channel
Local webhook server at /max/webhook with optional secret check
User allowlist through MAX_ALLOWED_USERS
Delivery target for cron and send_message through MAX_HOME_CHANNEL
AGENTS.md so a Hermes agent can install and configure the plugin itself
Health check endpoint on the local webhook server

When to use it

Chatting with a Hermes agent from Max
Receiving cron job results in a Max chat
Letting a Hermes agent set up its own Max channel from the repository instructions

Who it is for: Hermes Agent users who communicate through the Max messenger.

How it fits with Hermes Agent

Built for Hermes Agent as a gateway platform plugin, installed with hermes plugins install and configured through hermes gateway setup.

How to install Hermes Max Platform

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

pip install aiohttp httpx
hermes plugins install vladimiraldushin/hermes-max-platform --enable
hermes gateway setup
hermes gateway restart

Requirements: A Max chat-bot token (MAX_BOT_TOKEN), a public HTTPS webhook URL, and the aiohttp and httpx Python packages in the Hermes environment

Note: Creating a Max bot requires a verified profile as an organization, sole proprietor or self-employed person who is a Russian resident, and the README is written in Russian.

FAQ

What is Hermes Max Platform?

Hermes Max Platform is a Hermes Agent gateway plugin for the Max messenger. You message your Max bot and Hermes replies in the same conversation.

How do I install Hermes Max Platform?

Install aiohttp and httpx in the Hermes environment, run hermes plugins install vladimiraldushin/hermes-max-platform --enable, then run hermes gateway setup and hermes gateway restart. You also register a webhook subscription with Max.

What do I need to run Hermes Max Platform?

You need a Max chat-bot token and a public HTTPS URL pointing at port 8646 and the /max/webhook path. The README says that, as of 2026-06-22, Max bot creation was open to organizations, sole proprietors and self-employed people who are Russian residents.