# Add nmbr to Hermes Agent

> The nmbr platform adapter for Hermes Agent — two files in ~/.hermes/plugins/nmbr/ and your Hermes agent has a number.
>
> Markdown mirror of https://nmbr.ai/developers/docs/quickstart-hermes/ — part of the nmbr Agent API docs (https://nmbr.ai/developers/docs/). Spec: https://nmbr.ai/developers/openapi.yaml · Site index: https://nmbr.ai/llms.txt

**[Beta]** The adapter is new: tested against Hermes' `BasePlatformAdapter` contract and a mocked Agent API, not yet by many people inside Hermes itself. If something breaks, tell us at [support@nmbr.ai](mailto:support@nmbr.ai?subject=nmbr%20Hermes%20adapter) with the version and the error. Requires Hermes Agent ≥ 0.20 (Python ≥ 3.11); depends only on `httpx`, which Hermes ships.

## Add nmbr to Hermes in 2 minutes

1. In the nmbr app: **Agents → Yours → Create an agent**. Copy the token (shown once).
2. Install the adapter (two files into `~/.hermes/plugins/nmbr/`):
   ```bash
   curl -fsSL https://nmbr.ai/developers/hermes/install.sh | sh
   ```
   or by hand: download [`plugin.yaml`](/developers/hermes/plugin.yaml) and [`adapter.py`](/developers/hermes/adapter.py) into that directory.
3. Configure and run:
   ```bash
   hermes gateway setup     # pick nmbr, paste the token, add your own nmbr to allowed users
   hermes gateway start
   ```
   or with env vars: `NMBR_AGENT_TOKEN=agent:… NMBR_ALLOWED_USERS=123-456-789 hermes gateway start`.
4. Open the chat with your agent in nmbr and say hi.

## What you get

- **Two-way chat** with typing indicators; voice notes arrive as their transcript.
- **Approvals, fail-closed**: Hermes' dangerous-command prompt is delivered into the nmbr chat; reply `/approve`, `/always` or `/cancel` there. Native nmbr approval cards follow in v0.2.
- **Who can talk to the agent**: `NMBR_ALLOWED_USERS` is a list of nmbrs (`NMBR_ALLOW_ALL_USERS=true` trusts every contact who added the agent). nmbr itself already limits senders to contacts.
- **Cron and notifications** reach your phone via `NMBR_HOME_CHANNEL`, even when the gateway isn't running.

| Env | Meaning |
|---|---|
| `NMBR_AGENT_TOKEN` (required) | The agent token |
| `NMBR_BASE_URL` | API base, default `https://nmbr.ai/api` |
| `NMBR_ALLOWED_USERS` / `NMBR_ALLOW_ALL_USERS` | Who may talk |
| `NMBR_HOME_CHANNEL` / `_NAME` | Cron / notification target |

Files: [`plugin.yaml`](/developers/hermes/plugin.yaml) · [`adapter.py`](/developers/hermes/adapter.py) · [`install.sh`](/developers/hermes/install.sh) · [README](/developers/hermes/README.md)