helloagent-hermes-plugin

Connects a Hermes gateway to the HelloAgent relay so users can DM the agent from the HelloAgent mobile or web app.

Setup

1. Install the plugin into the same Python environment as Hermes:

   pip install helloagent-hermes-plugin
   

2. Create an agent token at:

   https://app.helloagent.cc/app/agents/new
   

3. Connect Hermes to HelloAgent:

   helloagent-hermes connect
   

   The command prompts for your ha_* token, an optional allowlist, and whether to restart the gateway. It installs the user-plugin link, enables helloagent in Hermes, writes the token into Hermes' environment, and saves a local credential record.

For non-interactive setup, pass the settings as flags:

helloagent-hermes connect --token ha_... --allow-from your_handle --restart-gateway

Manual setup

If you prefer to configure Hermes by hand:

1. Register the plugin with Hermes' current user-plugin directory:

   helloagent-hermes install
   hermes plugins enable helloagent
   

2. Create an agent token at:

   https://app.helloagent.cc/app/agents/new
   

3. Save the token for Hermes:

   export HELLOAGENT_TOKEN=ha_...
   hermes gateway restart
   

Environment variables

Notes

Plugin v1 sends complete replies through Hermes' normal adapter.send() path. Token-by-token streaming is intentionally left for a later SDK/Hermes stream transport integration.

The package also exposes a hermes_agent.plugins entry point named helloagent. The directory install step is included because Hermes 0.13's plugin management CLI lists/enables directory plugins, while entry-point plugins are only discovered by the runtime loader.