hermes-agent-plugin

This is a plugin for Hermes Agent, an AI assistant framework from NousResearch, that connects the agent to the Inkbox platform. Inkbox provides communication infrastructure: email mailboxes, phone numbers, SMS and MMS messaging, and voice calls. The plugin bridges Hermes to all of that, so the agent can receive and send messages and calls without you needing to build the integration yourself.

Once installed and configured, the plugin opens a persistent tunnel that routes incoming emails, text messages, and phone calls into the Hermes agent as conversations. The agent can reply by SMS, respond to group text threads, send emails from its Inkbox mailbox, and handle voice calls. For voice calls, it can use OpenAI's real-time audio API if you supply an API key, or fall back to the speech processing that Inkbox provides natively.

Setup starts with one command that installs the plugin and then runs a setup wizard. The wizard handles authentication with Inkbox, creates or links an agent identity, optionally provisions a US phone number, and writes all the required credentials to a configuration file. After that, you run a gateway process that stays running to receive inbound traffic.

The plugin also introduces the concept of post-call actions: during a phone call, the agent can schedule a follow-up SMS or email to be sent automatically after the call ends. Contact rules controlling who can reach the agent are managed through the Inkbox web console rather than locally, so the plugin defers to Inkbox's own allowlist and block-list settings.

This is intended for developers building AI agents that need real-world communication channels. It requires Hermes Agent to already be installed, and an Inkbox account or API key to be available.