Skip to content
BENIBIX Learn

Hermes Allowlist vs DM Pairing

People think the allowlist and DM pairing are two rival safety modes. They are two ways to fill the same guest list. With the allowlist, you type each user ID into the .env file. With pairing, a new person messages the bot, gets a one-time code, and you approve it. Use the list for a fixed team, and pairing to add people one by one.

AI🪽 Hermes Agent

Hermes Gateway Allowlist

The list of people the Hermes gateway will answer. All others get no reply.

The gateway allowlist is the list of people who may talk to Hermes Agent from a chat app. By default the gateway turns away all who are not on it or paired, since the bot can run commands on your machine. You write the list in the .env file. Each app gets its own line, or one line can cover all apps.

Example
Leo puts his own Telegram user ID in the list. A stranger who finds the bot gets no reply.
Why it matters
A bot that can run shell commands must not answer anyone who happens to find it.
Full entry
AI🪽 Hermes Agent

Hermes DM Pairing

A way to let a new person use Hermes with a code, not a list.

DM pairing is the Hermes Agent way to let a new person use the bot without typing their user ID into a list. When someone unknown messages the bot, they get a one-time pairing code. You approve them with hermes pairing approve, the app name and the code. Codes expire after one hour. Email senders are ignored unless email pairing is turned on.

Example
Mia's teammate messages the team bot and gets a code. He sends it to Mia, she approves it, and he can chat.
Why it matters
Finding a user ID is fiddly. A code lets you add a person in seconds and still stay in control.
Full entry

In one line

Hermes Gateway Allowlist
The list of people the Hermes gateway will answer. All others get no reply.
Hermes DM Pairing
A way to let a new person use Hermes with a code, not a list.