hermes atlas
318·repos hermes·v0.23.1 ★ star this repo

tenuo-ai/hermes-guests

Share selected Hermes capabilities with Telegram guests, with permissions you control.

★ 2 langPython licenseApache-2.0 updated2026-11-15

Hermes Guests lets an owner invite people to use Hermes through Telegram, with approved permissions and an access period. Guests have separate conversations and private memory, and their tool calls require a valid warrant.

  • Manage invitations, permissions, activity, and access from Telegram.
  • Guests use separate Hermes profiles and conversations.
  • Access and tool calls are limited by signed warrants.
full readme from github

Hermes Guests

Let friends and teammates use your Hermes through Telegram. Choose what they can do and how long they have access. They only need Telegram.

“Let Alex use my research tools until tomorrow.”

Hermes shows you the permissions to review. Approve, send Alex the invitation, and confirm their Telegram account when they join.

Alex can start asking questions in their own chat with your bot.

For a chat-only invitation, try “Let Alex chat for a day with no tools.”

Get started

You'll need Hermes with a working model and a Telegram bot. Set up the bot so your Telegram account is its only allowed user. Hermes Guests handles guest invitations.

1. Install Hermes Guests in the environment that runs your gateway.

hermes plugins install tenuo-ai/hermes-guests --enable --yes-deps

Review any source-scan findings. Follow Hermes's reload prompt, or restart the gateway if your deployment manages it separately. Installation help

2. Set up sharing when you're ready. Send a message in your private Telegram chat. Hermes replies as usual and offers Set up guest sharing once. You can ignore it and keep using Hermes. When you're ready, ask Hermes to share something or send /guests_setup. Review the setup and choose Enable sharing.

3. Say what you'd like to share. Use tools you've already connected to Hermes.

“Let Alex use my research tools for two days. Give them a day to accept.”

Check the permission review, then choose Approve, Change or Cancel. Send the invitation to Alex and confirm the account that claims it. Alex can then chat with the bot using the access you approved.

Keep it conversational

You can manage sharing from your own chat.

What you want Try saying
See current access “Who has access?”
Change permissions “Let Alex add to the shopping list too.”
Give more time “Extend Alex's access until Sunday.”
End access “End Alex's access.”
Check activity “What did Alex do today? Show the times in my timezone.”
Delete a guest's data “End Alex's access and delete their data.”
Never share something “Never let guests unlock the front door.”
Keep guest data for a set time “Delete guest data a week after access ends.”

Permission changes, never-share changes and deletion require your confirmation. Guests can inspect their permissions and request more access or time from their own chat.

Each guest has separate conversations and private memory. Ending access stops further model use and tool calls, while keeping their data for a possible return. Data is kept until you delete it by default; you can choose automatic deletion in /guests_setup, and each new guest's review says which applies.

Prefer buttons? /guests shows who has access, with Add a guest, Check sharing and Activity. Open a guest to change what they can use, Extend their access, see their activity or end it. Add a guest asks in words, or lets you pick from a list. See the command reference.

How access works

Every guest needs a valid signed warrant to chat or call a tool. The warrant limits what they can do and when access ends. Even chat-only access requires a warrant. Hermes Guests issues an owner warrant too. Your ordinary Hermes tools keep working if that warrant is missing or invalid. You can opt into requiring an owner warrant in advanced setup. Authorization details

This preview supports one owner and Telegram private text chats. Guests use your model quota. Their messages go to Telegram and your configured model. Approved tool calls send their inputs to the service you shared. Hermes stores guest conversations, memory, and access records locally in separate profiles.

Model setup · Security and limits

What it does on your machine

  • Background work. While the gateway runs, a maintenance task checks access every minute: it renews the owner and no-end-date warrants, sends the notices before and when access ends, and applies data retention.
  • Separate guest processes. Each guest turn runs a native Hermes agent in its own process, in a separate Hermes profile created for that guest. Its tool calls go through a server on 127.0.0.1 that checks the guest's warrant before anything runs.
  • Your configuration. When you press Enable sharing, Hermes Guests adds itself to your Telegram tools if you chose them explicitly. Guest profiles are created and, when you delete a guest's data, removed.
  • Keys and records. Signing keys, warrants, access records, receipts and activity are stored in the plugin's own data folder. Signing happens on this machine; see the trust model.
  • Network. Hermes Guests makes no network calls of its own beyond your model provider, through Hermes, and Telegram. Shared tools reach whatever services they already use. Nothing is reported anywhere.
  • Credentials. Model keys come from your Hermes profile, and a Codex sign-in is used through Hermes without the plugin holding the token.

Removing Hermes Guests

hermes plugins remove hermes-guests stops the plugin, but it leaves guest data and keys in place in case you reinstall. To remove everything:

  1. End each guest's access and delete their data first. In Telegram, send /guests, open each guest, and press End and delete data. This removes their guests-* Hermes profile, their conversations and their memories. Do this before removing the plugin, because nothing else will clean those profiles up afterwards.
  2. Remove the plugin: hermes plugins remove hermes-guests, then restart the gateway.
  3. Delete its data folder: plugin-data/agent-plugin-hermes-guests-* inside your Hermes profile. It holds the signing keys, warrants, access records and activity. Keep a copy if you want the activity history.
  4. Free the dependencies: hermes pm gc removes packages nothing uses any more. Don't delete files under installs/ by hand; if something looks wrong there, run hermes pm repair.

If a guests-* profile is still listed by hermes profile list after step 1, remove it with hermes profile delete <name>.

Contribute

Try the sharing scenarios, report an issue, or read CONTRIBUTING.md to work on the code.

Licensed under Apache-2.0.