Personal agents
Hermes Agent
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.
Before you begin
Section titled “Before you begin”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
- Open your project
- API keys
- Issue API key
tlm_••••••••••••••••Keys start with tlm_.
Never paste a key into a chat with Hermes. Every path below sets it for you.
Install
Section titled “Install”Connect Hermes Agent to Telem
-
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 | shTerminal window npx @telemai/create@latestIn PowerShell, with Node.js 20 or later. Or run the macOS and Linux command in WSL or Git Bash.
-
Restart Hermes. Hermes loads plugins when it starts.
-
Check the install.
telemshows asenabled.Terminal window hermes plugins list
Install with no prompts, for example in CI
curl -fsSL https://docs.telem.ai/install.sh | sh -s -- --yes --client hermes --key-env TELEM_API_KEYnpx @telemai/create@latest --yes --client hermes --key-env TELEM_API_KEYIn PowerShell, with Node.js 20 or later. Or run the macOS and Linux command in WSL or Git Bash.
-
Install and enable the plugin, and set your key. If Hermes asks to enable the plugin and to prepare its dependencies, answer
y. The plugin reads the key fromTELEM_API_KEY, so set it in the shell you start Hermes from:export TELEM_API_KEY=tlm_your_key.Terminal window hermes plugins install TelemAI/hermes-pluginhermes plugins enable telem -
Restart Hermes. Hermes loads plugins when it starts.
-
Check the install.
telemshows asenabled.Terminal window hermes plugins list
-
Start Hermes with your key set, and paste this prompt. Hermes runs the installer, which reads the key from
TELEM_API_KEY, so the key never goes into the chat.Terminal window export TELEM_API_KEY=tlm_your_keyhermesTerminal window $env:TELEM_API_KEY = "tlm_your_key"hermesSet up Telem web search for this coding agent.1. Read https://docs.telem.ai/llms.txt to learn what Telem is.2. Check that the TELEM_API_KEY environment variable is set. Do not print itsvalue. If it is not set, stop and ask me to set it and restart you.3. Run the Telem installer for this agent, with no prompts:curl -fsSL https://docs.telem.ai/install.sh | sh -s -- --yes --client hermes --key-env TELEM_API_KEYOn Windows, in PowerShell, run this instead:npx @telemai/create@latest --yes --client hermes --key-env TELEM_API_KEY4. Show me the installer's summary. Then tell me to restart Hermes,so that the Telem tools load. -
Restart Hermes. Hermes loads plugins when it starts.
-
Check the install.
telemshows asenabled.Terminal window hermes plugins list
If it does not work, see If something goes wrong.
Search and read
2 toolstelem_searchSearches the web on several providers in one call.telem_fetchReads the full text of up to 5 pages.
Specific to Hermes
Section titled “Specific to Hermes”- Finding the tools. They are in the
telemtoolset. 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_fetchscreens every URL itself. Hermes screens only its ownweb_extract. So before any request,telem_fetchuses 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_searchandweb_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.
Update and remove
Section titled “Update and remove”To update the plugin, run this command. When Hermes asks about the dependencies,
answer y.
hermes plugins update telemTo remove it:
hermes plugins remove telemThis 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. |
Learn more
Section titled “Learn more”Set the tier, the providers and auto-routing in one file, for Hermes and your other agents.
Every option, the values it takes, and which setting wins.
What each search option does, from tiers to date windows.
Choose the fetch provider and tier, or read pages live.