Hermes Plugin: Brave Search

Live web search inside Hermes Agent via the Brave Search API.

Registers one tool (brave_web_search) under the brave-search toolset.

Install

hermes plugins install rabilrbl/hermes-brave-search-plugin

During installation you will be prompted to enter your Brave Search API key (BRAVE_API_KEY). The value is saved to ~/.hermes/.env.

Getting your API key

Go to https://api-dashboard.search.brave.com/app/keys.
Sign up or log in.
Click + Add API Key and copy the subscription token.

Then set it manually if you skipped the prompt:

# ~/.hermes/.env
BRAVE_API_KEY="your-api-key-here"

Restart Hermes or run /reset to reload.

Usage

Enable the brave-search toolset:

hermes tools enable brave-search

Then ask Hermes to search:

Search for the latest Rust release notes

Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Search query
`count`	integer	No	Number of results (1–20, default 10)
`country`	string	No	Country code, e.g. `us`, `in`
`search_lang`	string	No	Result language code, e.g. `en`
`freshness`	string	No	Recency filter: `pd` (day), `pw` (week), `pm` (month), `py` (year)
`safesearch`	string	No	`off`, `moderate` (default), or `strict`

Example output

{
  "query": "Rust release notes",
  "count": 10,
  "results": [
    {
      "title": "Rust 1.78.0 | Rust Blog",
      "url": "https://blog.rust-lang.org/2024/05/02/Rust-1.78.0.html",
      "description": "Announcing Rust 1.78.0...",
      "source": "Rust Blog",
      "age": "2 weeks ago"
    }
  ]
}

Files

plugin.yaml — manifest and env requirements
schemas.py — tool schema shown to the model
tools.py — Brave Search API implementation
__init__.py — plugin registration wiring

License

MIT

brave-search

What it adds

Tools 1

Environment variables it needs 1

README