Skip to content

Personal agents

The Telem plugin adds web search and page reading to Hermes Agent as native tools. telem_fetch screens every URL before it reads the page.

Hermes 0.21.6 or newer, installed with the official Hermes installer. Homebrew builds of Hermes cannot install the plugin. For the installer, Node.js 20 or later; it checks for it and offers to install it.

Create a Telem API key

  1. Open your project
  2. API keys
  3. Issue API key

tlm_••••••••••••••••Keys start with tlm_.

Open the console

Never paste a key into a chat with Hermes. Every path below sets it for you.

Connect Hermes Agent to Telem

  1. Run the installer in your terminal. If it shows a menu, pick Hermes. Paste your key when the installer asks. The field is masked, and the key never appears on screen.

    Terminal window
    curl -fsSL https://docs.telem.ai/install.sh | sh
  2. Restart Hermes. Hermes loads plugins when it starts.

  3. Check the install. telem shows as enabled.

    Terminal window
    hermes plugins list
Install with no prompts, for example in CI
Terminal window
curl -fsSL https://docs.telem.ai/install.sh | sh -s -- --yes --client hermes --key-env TELEM_API_KEY

Search and read

2 tools
  • telem_search Searches the web on several providers in one call.
  • telem_fetch Reads the full text of up to 5 pages.
  • Finding the tools. They are in the telem toolset. Hermes’s tool search lists plugin tools by their name and the start of their description, so the model finds them when it searches its tools.
  • telem_fetch screens every URL itself. Hermes screens only its own web_extract. So before any request, telem_fetch uses Hermes’s checks to refuse a URL that holds something shaped like a key or token, a credential in a query parameter, a username or password, or a private or unsafe address. If the checks cannot run, every fetch is refused, and search still works.
  • Web content is marked as untrusted. Both tools wrap their output in Hermes’s untrusted-content block, and neutralize any copy of its delimiter in a page. This lowers the risk from instructions hidden in web pages. It does not remove it.
  • Hermes’s own web tools stay on. The plugin does not turn off web_search and web_extract; the tool descriptions steer the model to Telem.
  • Results stay inline. Each page is cut at 17,000 characters, and a whole result stays under 90,000, so Hermes shows it inline instead of saving it to a file.

To update the plugin, run this command. When Hermes asks about the dependencies, answer y.

Terminal window
hermes plugins update telem

To remove it:

Terminal window
hermes plugins remove telem

This deletes ~/.hermes/plugins/telem and removes telem from Hermes’s config.yaml. The change takes effect in your next Hermes session. If you run the Hermes gateway, restart it.

What the installer changed outside the plugin
File What it holds To undo
~/.telem/credentials.json Your key Delete it if no other Telem integration uses it.
~/.telem/telem.json Your Telem options Delete it if no other Telem integration uses it.
The telem-sdk Python package The client the plugin uses hermes plugins remove does not delete it.
Configuration

Set the tier, the providers and auto-routing in one file, for Hermes and your other agents.

Parameters

Every option, the values it takes, and which setting wins.

Search parameters

What each search option does, from tiers to date windows.

Fetch parameters

Choose the fetch provider and tier, or read pages live.

Was this page helpful?