https://github.com/rabilrbl/hermes-brave-search-plugin
Enable brave search in Hermes agent
https://github.com/rabilrbl/hermes-brave-search-plugin
brave-search brave-search-api hermes hermes-agent hermes-plugin
Last synced: 15 days ago
JSON representation
Enable brave search in Hermes agent
- Host: GitHub
- URL: https://github.com/rabilrbl/hermes-brave-search-plugin
- Owner: rabilrbl
- License: mit
- Created: 2026-04-11T11:33:01.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-06T11:58:28.000Z (3 months ago)
- Last Synced: 2026-06-14T22:03:14.498Z (about 1 month ago)
- Topics: brave-search, brave-search-api, hermes, hermes-agent, hermes-plugin
- Language: Python
- Homepage:
- Size: 8.79 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hermes Plugin: Brave Search
Live web search inside Hermes Agent via the [Brave Search API](https://brave.com/search/api/).
Registers one tool (`brave_web_search`) under the `brave-search` toolset.
## Install
```bash
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
1. Go to [https://api-dashboard.search.brave.com/app/keys](https://api-dashboard.search.brave.com/app/keys).
2. Sign up or log in.
3. Click **+ Add API Key** and copy the subscription token.
Then set it manually if you skipped the prompt:
```bash
# ~/.hermes/.env
BRAVE_API_KEY="your-api-key-here"
```
Restart Hermes or run `/reset` to reload.
## Usage
Enable the `brave-search` toolset:
```bash
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
```json
{
"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