103 lines
3.1 KiB
Markdown
103 lines
3.1 KiB
Markdown
---
|
|
name: hermes-tool-gateway-config
|
|
description: "Configure Hermes Agent to use Nous Tool Gateway for managed tools (web search, extract, image gen, TTS, STT, browser automation) via a single Nous Portal subscription."
|
|
version: 1.0.0
|
|
author: Hermes Agent
|
|
license: MIT
|
|
platforms: [linux, macos, windows]
|
|
metadata:
|
|
hermes:
|
|
tags: [Hermes, Nous-Portal, Tool-Gateway, Configuration, OpenRouter]
|
|
related_skills: [hermes-agent, github-auth, github-repo-management]
|
|
---
|
|
|
|
# Hermes Tool Gateway Configuration
|
|
|
|
Configure Hermes Agent to route tool calls through the Nous Tool Gateway — one subscription covers web search, extraction, image generation, TTS, STT, and cloud browser automation.
|
|
|
|
## Prerequisites
|
|
|
|
- **Nous Portal subscription** (paid tier required for managed tools)
|
|
- **OpenRouter API key** (for LLM inference)
|
|
- **Hermes Agent installed** and logged into Nous Portal (`hermes auth add nous`)
|
|
|
|
## Quick Setup
|
|
|
|
```bash
|
|
# 1. Log into Nous Portal (if not already)
|
|
hermes auth add nous --type oauth
|
|
|
|
# 2. Set OpenRouter as model provider
|
|
hermes config set model.provider openrouter
|
|
hermes config set model.default "nvidia/nemotron-3-ultra-550b-a55b:free"
|
|
|
|
# 3. Enable Tool Gateway for each tool category
|
|
hermes config set web.backend firecrawl
|
|
hermes config set web.search_backend tavily
|
|
hermes config set web.extract_backend firecrawl
|
|
hermes config set web.use_gateway true
|
|
|
|
hermes config set browser.use_gateway true
|
|
|
|
hermes config set tts.provider openai
|
|
hermes config set tts.use_gateway true
|
|
|
|
hermes config set stt.provider openai
|
|
hermes config set stt.use_gateway true
|
|
```
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
hermes status
|
|
```
|
|
|
|
Look for the **Nous Tool Gateway** section — all tools should show `✓ active via Nous subscription`.
|
|
|
|
## Config Reference
|
|
|
|
Key `config.yaml` entries:
|
|
|
|
```yaml
|
|
web:
|
|
backend: firecrawl
|
|
search_backend: tavily
|
|
extract_backend: firecrawl
|
|
use_gateway: true
|
|
|
|
browser:
|
|
use_gateway: true
|
|
|
|
tts:
|
|
provider: openai
|
|
use_gateway: true
|
|
|
|
stt:
|
|
provider: openai
|
|
use_gateway: true
|
|
```
|
|
|
|
## What Each Tool Gets
|
|
|
|
| Tool | Gateway Backend | Notes |
|
|
|------|----------------|-------|
|
|
| `web_search` | Firecrawl (managed) | Search backend: Tavily |
|
|
| `web_extract` | Firecrawl (managed) | Extract backend: Firecrawl |
|
|
| `image_generate` | FAL (FLUX 2 Klein 9B + 8 more) | 9 models available |
|
|
| `text_to_speech` | OpenAI TTS (gpt-4o-mini-tts) | Voice: alloy |
|
|
| STT (voice) | OpenAI Whisper-1 | Via voice mode |
|
|
| `browser_navigate` etc. | Browser Use (headless Chromium) | No Browserbase needed |
|
|
|
|
## Common Issues
|
|
|
|
| Issue | Fix |
|
|
|-------|-----|
|
|
| `Web tools ✓ included by subscription, not currently selected` | Set `use_gateway: true` for each tool category |
|
|
| `OpenAI TTS active via Nous subscription` but STT not working | Ensure `stt.provider: openai` AND `stt.use_gateway: true` |
|
|
| Browser automation fails | Verify `browser.use_gateway: true` and Node.js deps installed |
|
|
| Free Nous tier | Managed tools require **paid** subscription; free tier only gets inference |
|
|
|
|
## References
|
|
|
|
- `references/nous-tool-gateway.md` — Full documentation from Nous Portal integration guide
|
|
- `references/config-examples.yaml` — Complete config.yaml snippets for different setups |