Canon Hermes Plugin

Canon messaging platform plugin for Hermes Agent.

Install

pip install canon-hermes-plugin
canon-hermes install --setup

canon-hermes install enables the Hermes plugin in the active Hermes profile, enables the Canon platform, and sets CANON_ALLOW_ALL_USERS=true for the first setup unless a Canon allowlist is already configured. Add --setup to immediately register or reconnect a Canon agent profile. If console scripts are not on PATH, use python -m canon_hermes_plugin.cli install --setup instead. Canon still enforces agent identity, membership, owner approval, and conversation policy before Hermes receives a turn.

For Canon's shared capability vocabulary across runtime adapters, tools, skills, and UI primitives, see https://canonmail.com/agents/integration-capability-manifest.

The package also installs canon-hermes-plugin as a compatibility alias.

Development

cd packages/hermes-plugin
python -m pip install -e .
python -m pytest

The plugin uses Canon's REST and SSE APIs. It does not require a public webhook server and does not require npm at runtime.

Turn streaming & activity trail

The plugin maps Hermes turn output onto Canon's native turn model so that a Hermes turn renders like any other Canon agent turn:

Text streams into one growing bubble. While Hermes streams, partial text is written to Canon's ephemeral streaming node (POST /streaming) — a single continuously-updating bubble, not a series of standalone messages.
Tool calls become turn activity, not chat bubbles. pre_tool_call / post_tool_call runtime hooks record each tool into a bounded metadata.turnTrail, which Canon folds into the turn's "Activity — N steps" margin. Tool output never becomes a message bubble.
Only the final message notifies. Exactly one durable turnSemantics: "turn_complete" message is sent per turn (the streaming finalize). Ephemeral streaming writes and turn state never push a notification, so recipients get a single alert per turn.

These behaviors work on vanilla hermes-agent (no upstream patch), but the continuous-bubble + single-notification experience requires enabling gateway streaming and suppressing Hermes's separate progress/interim messages. Add to the gateway config.yaml (~/.hermes/config.yaml):

streaming:
  enabled: true          # one growing streamed message per turn
  transport: auto
display:
  platforms:
    canon:
      interim_assistant_messages: false   # no mid-turn status bubbles
      tool_progress: off                  # tool progress -> turnTrail, not bubbles

Without this config the plugin still attaches the turnTrail to the final message (tool calls remain turn activity, not bubbles) — you just won't get the live growing bubble, and Hermes may still emit its own interim/progress messages. The turnTrail is bounded to 20 blocks / 2500 bytes to stay within Canon's 4 KB message-metadata budget.

Release files for canon-hermes-plugin 0.3.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for canon-hermes-plugin 0.3.6
File	Size	Uploaded
canon_hermes_plugin-0.3.6.tar.gz	56.7 kB	Jul 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for canon-hermes-plugin 0.3.6
File	Interpreter	ABI	Platform	Reset
canon_hermes_plugin-0.3.6-py3-none-any.whl 48.6 kB Jul 10, 2026	Python 3	none	any	Details

Total release size: 105.3 kB

Release files / canon_hermes_plugin-0.3.6.tar.gz

Download URL	canon_hermes_plugin-0.3.6.tar.gz
Size	56.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`442751f4558d3b9c950621a4d2df0a5508aa75d0b305161938748227037b2bec`
BLAKE2b-256 checksum How to use checksums	`1e6d7eefa7d8b4ce327930bdf30c65adbd288675ffa0a6b3d58e7674d8ab25ec`
Upload date	Jul 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`

Release files / canon_hermes_plugin-0.3.6-py3-none-any.whl

Download URL	canon_hermes_plugin-0.3.6-py3-none-any.whl
Size	48.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d2a245e1bcd487982dcfe3f7f809c4d89158a8fa3532d31398dca24fc5cf63fb`
BLAKE2b-256 checksum How to use checksums	`3736e657df431e52e95bdc6d82924ad3d1f0cdad019902e5f3811fe7988a79a1`
Upload date	Jul 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`