-
Notifications
You must be signed in to change notification settings - Fork 40
Custom Tools
One of Hermes' most powerful features is the ability to create new tools on the fly. This means you can extend Hermes' capabilities without programming knowledge — just describe what you want.
Wrap any web API as a Hermes tool. You give it a URL, HTTP method, and parameters, and it generates a tool that calls that API.
Example: Weather API tool Say: "Create a tool called 'get_weather' that calls https://api.openweathermap.org/data/2.5/weather with a 'q' query parameter for the city name"
After creation, you can say: "Get the weather in Portland" and Hermes will use your new tool.
Example: Discord webhook tool Say: "Create a tool that posts messages to my Discord webhook at [URL]"
Example: Stock price tool Say: "Create a tool that fetches stock prices from the Yahoo Finance API"
Write arbitrary Python logic as a tool. You describe the parameters and the code, and Hermes generates a working tool.
Example: File size calculator Say: "Create a tool called 'dir_size' that takes a path and returns the total size of all files in that directory in MB"
Example: Text statistics Say: "Create a tool that counts words, sentences, and paragraphs in text"
- Custom tools persist across sessions (saved in
tools/custom/) - Say "List my custom tools" to see what you've created
- Say "Delete the [tool_name] tool" to remove one
- Custom tools reload automatically when Hermes restarts