Inkbox

> # Documentation index
> Fetch the complete documentation index at: https://inkbox.ai/sitemap.xml
> Use this file to discover all available pages before exploring further.

---

# Hermes Agent plugin
description: Give your Hermes agent an Inkbox email address, phone number, and tunnel

---


# Hermes Agent plugin

The [Inkbox Hermes Agent plugin](https://github.com/inkbox-ai/hermes-agent-plugin) is a standalone platform plugin for [Hermes Agent](https://github.com/NousResearch/hermes-agent). It gives a Hermes agent its own Inkbox identity: mailbox, phone number, SMS/MMS, voice calls, contact rules, an Inkbox tunnel, realtime phone calls, and bundled Inkbox skills.

This is a plugin, not an Inkbox SDK skill or Hermes fork. It lives in its own repository and wires Inkbox directly into Hermes' plugin system, gateway, tools, CLI, setup wizard, and bundled task skills.

<YouTubeEmbed id="b7dqf9_SutM" title="Hermes Agent plugin + Inkbox demo" />

[View plugin on GitHub](https://github.com/inkbox-ai/hermes-agent-plugin)

## Install

Install and configure [upstream Hermes Agent](https://hermes-agent.nousresearch.com/docs/getting-started/installation) first.

For macOS, Linux, or WSL2:

```bash
# Install Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc

# Configure your model provider
hermes setup
```

For native Windows PowerShell:

```bash
# Install Hermes Agent
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

# Configure your model provider
hermes setup
```

Install and enable the Inkbox plugin:

```bash
hermes plugins install inkbox-ai/hermes-agent-plugin --enable
```

Configure Inkbox and start or restart the gateway:

```bash
# Configure Inkbox
hermes inkbox setup

# Check the Inkbox configuration
hermes inkbox doctor

# Start the gateway
hermes gateway run

# If gateway is already running, restart it
hermes gateway restart
```

If the gateway is already running, restart it so it reloads the Inkbox platform config. Keep the gateway process running. On startup the plugin opens an Inkbox tunnel, configures mail and text webhook subscriptions, wires the incoming-call URL, and routes inbound email, SMS, and calls into Hermes sessions.

To update an existing install:

```bash
hermes plugins update inkbox
hermes gateway restart
```

## What you get

By the end of setup your Hermes agent has:

- **An email address** - send, receive, and reply from an Inkbox mailbox
- **A phone number** - SMS/MMS and voice calls, inbound and outbound
- **An Inkbox tunnel** - inbound webhooks and WebSocket connections reach the local Hermes gateway without a public server
- **Contacts and contact rules** - persistent Inkbox records and server-side allow/block controls
- **Bundled Inkbox skills** - email triage, SMS response, contact lookup, outbound calling, notes, and credential workflows

## What Inkbox adds

| Capability | Hermes Agent alone | With Inkbox plugin |
| --- | --- | --- |
| Agent-owned mailbox | Bring your own integration | Built in |
| SMS/MMS and voice calls | Bring your own integration | Built in |
| Inbound webhook and WebSocket tunnel | Bring your own tunnel/server | Built in |
| Contact and reachability controls | Agent memory or external tools | Built in |
| Realtime phone-call bridge | Bring your own integration | Built in |

Hermes Agent itself stays upstream. The plugin adds an Inkbox platform adapter, tool group, CLI setup wizard, gateway webhook routing, and package-included task skills without requiring a Hermes fork.

## After install

Run a quick health check:

```bash
hermes inkbox doctor
hermes plugins list
hermes gateway run
```

Then text `START` to the agent's Inkbox phone number from every phone the agent needs to text. This opts that phone number in to SMS from the agent. You can also email the agent mailbox or call the agent phone number; the gateway routes those inbound events into Hermes.

## Manage who can reach the agent

Inkbox reachability is controlled server-side with per-agent contact rules. Use the [Inkbox console contact rules](https://inkbox.ai/console/contact-rules) to allow or block specific contacts, phone numbers, email addresses, or domains. Each agent identity's mail and phone filter modes decide whether unmatched senders are allowed by default or rejected.

## Related

- [Inkbox Hermes Agent plugin on GitHub](https://github.com/inkbox-ai/hermes-agent-plugin)
- [Hermes Agent on GitHub](https://github.com/NousResearch/hermes-agent)
- [Hermes Agent docs](https://hermes-agent.nousresearch.com/docs/)