# Hermes Guests: Hermes Agent plugin

> Let someone use part of your Hermes from their own Telegram chat, for as long as you choose.

Canonical: https://hermeswatcher.com/plugins/hermes-guests  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/hermes-guests  
Last updated in catalog: 2026-11-17

Let someone use part of your Hermes from their own Telegram chat, for as long as you choose. Say it in plain words ("let Mia read the recipes and add to the shopping list until Sunday") or pick from a menu, review the card, approve, and send the invitation. Each guest gets their own Hermes profile, chat and memory, and every call they make is checked against a signed, expiring Tenuo grant before it runs. Change, extend or end access from your own chat.

## Good to know before installing

Runs a maintenance task every minute while the gateway runs (renews grants, sends end-of-access notices, applies data retention and deletes ended guest profiles); runs each guest turn as a local Hermes agent process in a separate guest profile, with tool calls going through a server on 127.0.0.1 that checks the guest's grant and then runs the shared tool through the plugin tool-dispatch API, where other plugins' pre_tool_call guards do not see it; guest turns use the owner's configured model and quota (a Codex sign-in through credentialed_provider_request, API keys through the profile secret scope, handed to the guest process over a private pipe and never stored in guest profiles); creates and deletes guest profiles; once sharing is set up it answers every private Telegram message from anyone but the owner before Hermes's own pairing, so people the bot already admitted get only their scoped guest access instead of the full agent, and new people get a no-access reply instead of a pairing code; when the owner enables sharing, adds itself to an explicit Telegram tool selection; stores signing keys, grants, access records and activity in its plugin data folder; its pre_tool_call hook refuses tool calls from anyone but the owner in Telegram sessions and checks the owner's calls against an owner grant (falling back to Hermes unless require_owner_warrant is set); its pre_llm_call hook adds sharing context to the owner's Telegram turns; registers /guests and a Telegram handler for the owner and guest commands. No network calls of its own beyond Telegram and the model provider through Hermes; no telemetry, no self-update.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install hermes-guests
```

2. Said no? Turn it on later:

```bash
hermes plugins enable hermes-guests
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Memory & notes, Chat apps & voice
- Maintained by: tenuo-ai (Community)
- Needs: No API keys declared
- Adds tools: `guests_discover`, `guests_prepare_access`, `guests_list_access`, `guests_activity`, `guests_repair`, `guests_status`, `guests_data`, `guests_never`
- Requires Hermes: `>=0.22.6`
- Version: 0.1.0
- In the catalog since: 2026-11-17

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/hermes-guests)
- [Source code](https://github.com/tenuo-ai/hermes-guests/blob/v0.1.0/docs/how-sharing-works.md)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
