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
description: Give your Hermes agent an email address and phone number with one curl

---


# Hermes Agent

[Hermes Agent](https://github.com/NousResearch/hermes-agent) is an open-source AI agent harness by Nous Research. Inkbox maintains a [fork](https://github.com/inkbox-ai/hermes-agent) that wires the harness directly into Inkbox, so every install ships with an email, a phone number with SMS + voice, and a tunnel — out of the box.

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

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

## Install

One command. Installs Hermes and its dependencies, walks you through Inkbox self-signup, provisions email + phone, installs the gateway as a background service that auto-starts on boot.

```bash
curl -fsSL https://raw.githubusercontent.com/inkbox-ai/hermes-agent/inkbox/scripts/install.sh | bash
```

For native Windows (early beta) use PowerShell instead:

```bash
irm https://raw.githubusercontent.com/inkbox-ai/hermes-agent/inkbox/scripts/install.ps1 | iex
```

## What you get

By the end of the install your agent has:

- **An email address** — `yourname@inkboxmail.com`, send and receive
- **A phone number** — SMS and voice calls, inbound and outbound
- **A public webhook tunnel** — inbound webhooks from email and phone reach the gateway on your machine without you running a public server
- **A background gateway service** that auto-starts on boot, with HMAC-verified webhooks
- **No account prerequisite** — the wizard handles Inkbox self-signup inline

## What Inkbox adds

| Capability | Upstream Hermes | This fork |
| --- | --- | --- |
| Chat platforms (Telegram, Slack, Discord, …) | 🟢 | 🟢 |
| Email address | 🟡 BYO (SMTP provider) | 🟢 |
| Phone (SMS + voice) | 🟡 BYO (Twilio + SIP) | 🟢 |
| Public webhook tunnel | 🟡 BYO (ngrok / server) | 🟢 |
| Persistent contact list | 🟡 BYO (agent memory) | 🟢 |
| Zero-knowledge vault for secrets | 🟡 BYO (1Password) | 🟢 |

The agent harness — CLI, supported models, skills, memory, tools, terminal backends, scheduled jobs, RL training — is unchanged from upstream. The fork only touches the integration layer.

## Synced daily with upstream

A scheduled workflow merges [`NousResearch/hermes-agent@main`](https://github.com/NousResearch/hermes-agent) into the fork's `inkbox` branch every day. Every upstream commit reaches this fork within ~24 hours — no version-pinning lag.

## After install

Start chatting from your terminal:

```bash
hermes
```

Or just text or email your agent at the phone number / email it was provisioned with. The gateway running in the background routes inbound messages into the agent's session.

## Manage who can reach the agent

By default the agent's mailbox and phone number accept inbound traffic from any sender. Open the [Inkbox console contact rules](https://inkbox.ai/console/contact-rules) to allow or block specific contacts, phone numbers, email addresses, or domains. Per-mailbox and per-number filter modes (whitelist vs blacklist) decide whether unmatched senders are allowed by default or rejected.

## Related

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