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 version: /developers/docs/quickstart-hermes.md · Spec: /developers/openapi.yaml
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 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
- In the nmbr app: Agents → Yours → Create an agent. Copy the token (shown once).
- Install the adapter (two files into
~/.hermes/plugins/nmbr/):
or by hand: downloadcurl -fsSL https://nmbr.ai/developers/hermes/install.sh | shplugin.yamlandadapter.pyinto that directory. - Configure and run:
or with env vars:hermes gateway setup # pick nmbr, paste the token, add your own nmbr to allowed users hermes gateway startNMBR_AGENT_TOKEN=agent:… NMBR_ALLOWED_USERS=123-456-789 hermes gateway start. - 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,/alwaysor/cancelthere. Native nmbr approval cards follow in v0.2. - Who can talk to the agent:
NMBR_ALLOWED_USERSis a list of nmbrs (NMBR_ALLOW_ALL_USERS=truetrusts 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 · adapter.py · install.sh · README