# Hermes Plugins

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

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** ~/.hermes/plugins, hermes plugins install, Hermes plugin.yaml

## Think of it like

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

## 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

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

## 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.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [Hermes Toolset](https://learn.benibix.com/term/ai/hermes-toolset)
- [Hermes Hooks](https://learn.benibix.com/term/ai/hermes-hooks)
- [Hermes MCP Servers](https://learn.benibix.com/term/ai/hermes-mcp-servers)
- [Hermes Home Folder](https://learn.benibix.com/term/ai/hermes-home)
- [Tool Use (Function Calling)](https://learn.benibix.com/term/ai/tool-use)

## Told apart from

- [Hermes Skill vs Plugin](https://learn.benibix.com/compare/hermes-skill-vs-hermes-plugins): People think a plugin and a skill are the same kind of add-on. They are not. A skill is a written method the agent reads when a task needs it. A plugin is Python code that gives the agent new tools or hooks, and it stays off until you enable it. Use a skill to teach a way of working. Use a plugin to add a new ability.

![Two panels. Left, your shell, holds hermes model, hermes update, hermes plugins install and hermes --tui. Right, inside a chat, holds /model, /goal, /voice and /compress. An arrow says the left side adds things and the right side only picks from them.](https://learn.benibix.com/diagrams/ai8-hermes-commands.svg)

---

Source: https://learn.benibix.com/term/ai/hermes-plugins
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
