explaingit

inkbox-ai/hermes-agent-plugin

12PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A plugin that connects the Hermes AI agent framework to Inkbox's communication platform, giving your agent a real phone number, email mailbox, SMS/MMS, and voice call capability with a one-command setup wizard.

Mindmap

mindmap
  root((hermes-agent-plugin))
    What it does
      Email and SMS for agents
      Voice calls
      Real phone number
    Channels
      Inbound emails
      SMS and MMS threads
      Voice calls
    Features
      Post-call follow-up
      OpenAI real-time audio
      Inkbox contact rules
    Setup
      One-command wizard
      Inkbox API key
      Gateway process
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Give a Hermes AI agent a real US phone number so it can receive and reply to SMS messages from users without you building the integration.

USE CASE 2

Let an AI agent handle inbound voice calls and automatically send a follow-up SMS or email after each call ends.

USE CASE 3

Connect an AI agent to an email mailbox so it can read incoming emails and reply from its own Inkbox address.

USE CASE 4

Build a customer-facing AI agent that handles multi-channel communication (email, SMS, and voice) through a single plugin.

Tech stack

PythonHermes AgentInkbox APIOpenAI API

Getting it running

Difficulty · moderate Time to first run · 30min

Requires an existing Hermes Agent installation and an Inkbox account or API key, a persistent gateway process must stay running to receive inbound traffic.

No license information was mentioned in the explanation.

In plain English

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.

Copy-paste prompts

Prompt 1
Run the hermes-agent-plugin setup wizard to provision a new US phone number, link it to my Hermes agent, and configure SMS inbound routing, walk me through each wizard step.
Prompt 2
Show me how to configure the hermes-agent-plugin post-call action so my Hermes agent automatically sends a follow-up SMS 5 minutes after every voice call ends.
Prompt 3
I want my Hermes agent to receive emails and reply from an Inkbox mailbox. Walk me through the plugin configuration and show me the code that handles inbound email events.
Prompt 4
Configure the hermes-agent-plugin to use OpenAI's real-time audio API for voice calls instead of the Inkbox native speech processing, what credentials do I need and how do I set them up?
Prompt 5
My Hermes agent is live with the Inkbox plugin. Show me how to manage the contact allowlist and blocklist through the Inkbox web console so only approved numbers can reach the agent.
Open on GitHub → Explain another repo

← inkbox-ai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.