Files

3.1 KiB

name, description, version, author, license, platforms, metadata
name description version author license platforms metadata
hermes-tool-gateway-config 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. 1.0.0 Hermes Agent MIT
linux
macos
windows
hermes
tags related_skills
Hermes
Nous-Portal
Tool-Gateway
Configuration
OpenRouter
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

# 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

hermes status

Look for the Nous Tool Gateway section — all tools should show ✓ active via Nous subscription.

Config Reference

Key config.yaml entries:

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