Skip to content
BENIBIX Learn

Hermes Plugins

AI🪽 Hermes AgentHermes Tools

Also known as ~/.hermes/plugins, hermes plugins install, Hermes plugin.yaml

Python code that adds tools or hooks to Hermes. It stays off until enabled.

Think of it like

It is like adding a new tool to a toolbox. The box stays the same, but it can do more.

Example

Jack writes a plugin with one tool that looks up his shop's orders. He enables it, and Hermes can now answer order questions.

Why it matters

Plugins let you give Hermes your own tools, so it can work with systems only you use.

Definition

A Hermes plugin adds new tools or hooks to Hermes without changing its own code. It is a folder in ~/.hermes/plugins with a plugin.yaml file and some Python. The yaml file names the tools and hooks the plugin gives. Plugins are off until you turn them on with hermes plugins enable. After that, the model can call the new tools like any built-in one.

Example code

bash
hermes plugins install owner/repo
hermes plugins enable my-plugin
hermes plugins
Install a plugin, turn it on, then see the list.
Plugins are added from the shell. The tools they bring then show up in every chat.

Common mistake

Dropping a folder in and expecting it to load. Plugins stay off until you enable them.

Key takeaways

  1. 1
    A folder. plugin.yaml plus Python code.
  2. 2
    Off by default. Enable each one by name.
  3. 3
    Tools or hooks. Add abilities or watch events.

Compare