Nous Tool Gateway

기준일: 2026-07-26
공식 기준: Nous Tool Gateway

Nous Tool Gateway 문서는 Hermes Agent 공식 문서(user-guide/features/tool-gateway)를 한국어로 정리한 가이드입니다. One subscription, every tool. Web search, image generation, TTS, and cloud browsers — all routed through Nous Portal with no extra API keys. 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치 버전과 공식 원문을 확인하세요.

핵심 요약

One subscription, every tool. Web search, image generation, TTS, and cloud browsers — all routed through Nous Portal with no extra API keys.

한국어 가이드 범위: user-guide/features/tool-gateway 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Nous Tool Gateway
• What's included
• Why it's here
• Get started
• Eligibility
• Mix and match
• Using individual image models
• Configuration reference
• Per-tool use_gateway flag
• Disabling the gateway
• Self-hosted gateway (advanced)
• FAQ
• Does it work with Telegram / Discord / the other messaging gateways?
• What happens if my subscription expires?
• Can I see usage or costs per tool?
• Is Modal (serverless terminal) included?
• Do I need to delete my existing API keys when I enable the gateway?

상세 내용

Nous Tool Gateway

The Tool Gateway is included with every paid Nous Portal subscription. It routes Hermes' tool calls — web search, image generation, text-to-speech, and cloud browser automation — through infrastructure Nous already runs, so you don't have to sign up with Firecrawl, FAL, OpenAI, Browser Use, or anyone else just to make your agent useful.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

What's included

All four are pay-as-you-use billed against your Nous subscription. Use any combination — run the gateway for web and images while keeping your own ElevenLabs key for TTS, or route everything through Nous.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

	Tool	What you get
🔍	Web search & extract	Agent-grade web search and full-page extraction via Firecrawl. No rate limits to worry about — the gateway handles scaling.
🎨	Image generation	Nine models under one endpoint: FLUX 2 Klein 9B, FLUX 2 Pro, Z-Image Turbo, Nano Banana Pro (Gemini 3 Pro Image), GPT Image 1.5, GPT Image 2, Ideogram V3, Recraft V4 Pro, Qwen Image. Pick per-generation with a flag, or let Hermes default to FLUX 2 Klein.
🔊	Text-to-speech	OpenAI TTS voices wired into the text_to_speech tool. Drop voice notes into Telegram, generate audio for pipelines, narrate anything.
🌐	Cloud browser automation	Headless Chromium sessions via Browser Use. browser_navigate, browser_click, browser_type, browser_vision — all the agent-driving primitives, no Browserbase account required.

Why it's here

Building an agent that can actually do things means stitching together 5+ API subscriptions — each with their own signup, rate limits, billing, and quirks. The gateway collapses that into one account:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

주요 항목:

• One bill. Pay Nous; we handle the rest.
• One signup. No Firecrawl, FAL, Browser Use, or OpenAI audio accounts to manage.
• One key. Your Nous Portal OAuth covers every tool.
• Same quality. Same backends the direct-key route uses — just fronted by us.

Get started

There are three ways in — pick whichever fits where you are:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

hermes setup --portal     # Fresh install: Nous OAuth + set Nous as provider + turn on the Tool Gateway in one go

hermes model              # Switch your inference provider to Nous Portal — Hermes then offers to turn on the gateway for all tools

hermes tools              # Enable the gateway per-tool — pick "Nous Subscription" for any tool you want

hermes portal info        # Portal auth + Tool Gateway routing summary
hermes portal tools       # Gateway catalog with current routing per tool
hermes status             # Full system status (Tool Gateway is one section)

◆ Nous Tool Gateway
  Nous Portal     ✓ managed tools available
  Web tools       ✓ active via Nous subscription
  Image gen       ✓ active via Nous subscription
  TTS             ✓ active via Nous subscription
  Browser         ○ active via Browser Use key

Eligibility

The Tool Gateway is a paid-subscription feature. Free-tier Nous accounts can use Portal for inference but don't include managed tools — upgrade your plan to unlock the gateway.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

Mix and match

The gateway is per-tool. Turn it on for just what you want:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

주요 항목:

• All tools through Nous — easiest; one subscription, done.
• Gateway for web + images, bring your own TTS — keep your ElevenLabs voice, let Nous handle the rest.
• Gateway only for things you don't have keys for — "I already pay for Browserbase, but I don't want a Firecrawl account" works fine.

hermes tools          # Interactive picker for each tool category

Using individual image models

Image generation defaults to FLUX 2 Klein 9B for speed. Override per-call by passing the model ID to the image_generate tool:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

Model	ID	Best for
FLUX 2 Klein 9B	fal-ai/flux-2/klein/9b	Fast, good default
FLUX 2 Pro	fal-ai/flux-2-pro	Higher fidelity FLUX
Z-Image Turbo	fal-ai/z-image/turbo	Stylized, fast
Nano Banana Pro	fal-ai/nano-banana-pro	Google Gemini 3 Pro Image
GPT Image 1.5	fal-ai/gpt-image-1.5	OpenAI image gen, text+image
GPT Image 2	fal-ai/gpt-image-2	OpenAI latest
Ideogram V3	fal-ai/ideogram/v3	Strong prompt adherence + typography
Recraft V4 Pro	fal-ai/recraft/v4/pro/text-to-image	Vector-style, graphic design
Qwen Image	fal-ai/qwen-image	Alibaba multimodal

Configuration reference

Most users never need to touch this — hermes model and hermes tools cover every workflow interactively. This section is for writing config.yaml directly or scripting setups.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

Per-tool use_gateway flag

Each tool's config block takes a use_gateway boolean:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

web:
  backend: firecrawl
  use_gateway: true

image_gen:
  use_gateway: true

tts:
  provider: openai
  use_gateway: true

browser:
  cloud_provider: browser-use
  use_gateway: true

Disabling the gateway

hermes tools automatically clears the flag when you pick a non-gateway provider, so this usually happens for you.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

web:
  use_gateway: false   # Hermes now uses FIRECRAWL_API_KEY from .env

Self-hosted gateway (advanced)

Running your own Nous-compatible gateway? Override endpoints in ~/.hermes/.env:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

TOOL_GATEWAY_DOMAIN=your-domain.example.com
TOOL_GATEWAY_SCHEME=https
TOOL_GATEWAY_USER_TOKEN=your-token        # normally auto-populated from Portal login
FIRECRAWL_GATEWAY_URL=https://...         # override one endpoint specifically

FAQ

이 섹션의 세부 항목은 공식 문서 FAQ를 참고하세요.

Does it work with Telegram / Discord / the other messaging gateways?

Yes. Tool Gateway operates at the tool-execution layer, not the CLI. Every interface that can call a tool — CLI, Telegram, Discord, Slack, IRC, Teams, the API server, anything — benefits from it transparently.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

What happens if my subscription expires?

Tools routed through the gateway stop working until you renew or swap in direct API keys via hermes tools. Hermes shows a clear error pointing at the portal.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

Can I see usage or costs per tool?

Yes — the Nous Portal dashboard breaks usage down by tool so you can see what's driving your bill.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

Is Modal (serverless terminal) included?

Modal is available as an optional add-on through the Nous subscription, not part of the default Tool Gateway bundle. Configure it via hermes setup terminal or directly in config.yaml when you want a remote sandbox for shell execution.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

Do I need to delete my existing API keys when I enable the gateway?

No — keep them in .env. When use_gateway: true, Hermes skips direct keys and uses the gateway. Flip the flag back to false and your keys become the source again. The gateway isn't a lock-in.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문을 확인하세요.

실습 체크리스트

1. 공식 문서와 설치된 Hermes 버전을 대조합니다.
2. 관련 CLI는 hermes --help 및 하위 명령 --help로 확인합니다.
3. Gateway·메시징 변경 후 hermes gateway 재시작을 검토합니다.
4. 시크릿·토큰은 환경 변수/시크릿 매니저에만 둡니다.

자주 쓰는 명령·설정 예시

hermes setup --portal     # Fresh install: Nous OAuth + set Nous as provider + turn on the Tool Gateway in one go

hermes model              # Switch your inference provider to Nous Portal — Hermes then offers to turn on the gateway for all tools

hermes tools              # Enable the gateway per-tool — pick "Nous Subscription" for any tool you want

hermes portal info        # Portal auth + Tool Gateway routing summary
hermes portal tools       # Gateway catalog with current routing per tool
hermes status             # Full system status (Tool Gateway is one section)

◆ Nous Tool Gateway
  Nous Portal     ✓ managed tools available
  Web tools       ✓ active via Nous subscription
  Image gen       ✓ active via Nous subscription
  TTS             ✓ active via Nous subscription
  Browser         ○ active via Browser Use key

hermes tools          # Interactive picker for each tool category

web:
  backend: firecrawl
  use_gateway: true

image_gen:
  use_gateway: true

tts:
  provider: openai
  use_gateway: true

browser:
  cloud_provider: browser-use
  use_gateway: true

web:
  use_gateway: false   # Hermes now uses FIRECRAWL_API_KEY from .env

관련 링크

• 공식 원문: user-guide/features/tool-gateway
• 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·API 이름은 설치 버전에 따라 달라질 수 있습니다.