Nous Tool Gateway

하나의 구독. 모든 도구 내장.

Tool Gateway는 모든 유료 Nous Portal 구독에 포함됩니다. Hermes의 웹 검색, 이미지 생성, 텍스트 음성 변환, 클라우드 브라우저 자동화 호출을 Nous가 운영하는 인프라를 통해 라우팅하므로, 에이전트에 실용적인 도구를 붙이기 위해 Firecrawl, FAL, OpenAI, Browser Use 같은 서비스에 따로 가입할 필요가 없습니다.

구독 시작 또는 관리 →

포함된 항목

	도구	받는 항목
🔍	웹 검색 및 추출	Firecrawl 기반 에이전트급 웹 검색과 전체 페이지 추출. 속도 제한은 게이트웨이가 확장 처리하므로 직접 관리할 필요가 없습니다.
🎨	이미지 생성	하나의 엔드포인트에서 아홉 모델을 사용합니다: 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. 호출마다 플래그로 모델을 고르거나 Hermes 기본값인 FLUX 2 Klein을 그대로 사용할 수 있습니다.
🔊	텍스트 음성 변환	OpenAI TTS 음성이 text_to_speech 도구에 연결됩니다. Telegram에 음성 메모를 올리거나, 파이프라인용 오디오를 만들거나, 텍스트를 내레이션할 수 있습니다.
🌐	클라우드 브라우저 자동화	Browser Use 기반 헤드리스 Chromium 세션. browser_navigate, browser_click, browser_type, browser_vision 같은 에이전트 구동 프리미티브를 Browserbase 계정 없이 사용할 수 있습니다.

네 가지 모두 사용량 기준으로 Nous 구독에 청구됩니다. 원하는 조합으로 사용할 수 있습니다. 예를 들어 웹과 이미지는 게이트웨이로 라우팅하면서 TTS에는 자체 ElevenLabs 키를 유지하거나, 모든 도구를 Nous를 통해 라우팅할 수 있습니다.

왜 여기에 있는지

실제로 무언가를 할 수 있는 에이전트를 만들려면 보통 가입, 속도 제한, 청구 방식, 동작 특성이 제각각인 여러 API 구독을 이어 붙여야 합니다. 게이트웨이는 이를 하나의 계정으로 통합합니다.

• 하나의 청구서. Nous에 결제하면 나머지는 Nous가 처리합니다.
• 한 번의 가입. Firecrawl, FAL, Browser Use, OpenAI 오디오 계정을 따로 관리할 필요가 없습니다.
• 하나의 키. Nous Portal OAuth 하나로 모든 도구를 사용할 수 있습니다.
• 동일한 품질. 직접 API 키 경로와 같은 백엔드를 사용하되, Nous가 앞단에서 라우팅합니다.

언제든지 도구별 직접 키로 전환할 수 있습니다. 게이트웨이는 잠금 장치가 아니라 설정을 줄여 주는 지름길입니다.

시작하기

hermes model          # Pick Nous Portal as your provider

Nous Portal을 선택하면 Hermes가 Tool Gateway를 켤지 묻습니다. 수락하면 설정은 끝납니다. 다음 실행부터 지원되는 모든 도구가 활성화됩니다.

언제든지 활성 상태를 확인하세요:

hermes status

다음과 같은 섹션을 보게 될 것입니다:

◆ 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

active via Nous subscription으로 표시된 도구는 게이트웨이를 통해 동작합니다. 그 외의 도구는 사용자의 직접 키를 사용합니다.

자격

Tool Gateway는 유료 구독 기능입니다. 무료 Nous 계정은 추론용 Portal을 사용할 수 있지만 관리형 도구는 포함하지 않습니다. 게이트웨이를 사용하려면 플랜을 업그레이드하세요.

섞어 쓰기

게이트웨이는 도구별로 켤 수 있습니다. 필요한 항목만 선택하세요.

• 모든 도구를 Nous로 라우팅 — 가장 간단합니다. 구독 하나로 끝납니다.
• 웹 + 이미지는 게이트웨이, TTS는 직접 키 — ElevenLabs 음성은 유지하고 나머지만 Nous에 맡깁니다.
• 키가 없는 도구만 게이트웨이 사용 — 이미 Browserbase를 쓰고 있지만 Firecrawl 계정은 만들고 싶지 않은 경우도 가능합니다.

언제든지 다음을 통해 도구를 전환하세요:

hermes tools          # Interactive picker for each tool category

도구를 선택한 뒤 제공자로 Nous Subscription을 고르세요. 선호하는 직접 제공자를 선택해도 됩니다. config.yaml을 직접 편집할 필요는 없습니다.

개별 이미지 모델 사용

이미지 생성은 속도를 위해 기본적으로 FLUX 2 Klein 9B로 설정됩니다. 호출마다 모델 ID를 image_generate 도구에 전달해 덮어쓸 수 있습니다.

모델	ID	적합한 용도
FLUX 2 Klein 9B	fal-ai/flux-2/klein/9b	빠르고 안정적인 기본값
FLUX 2 Pro	fal-ai/flux-2/pro	더 높은 충실도의 FLUX
Z-Image Turbo	fal-ai/z-image/turbo	스타일화된 빠른 이미지
Nano Banana Pro	fal-ai/gemini-3-pro-image	Google Gemini 3 Pro Image
GPT Image 1.5	fal-ai/gpt-image-1/5	OpenAI 이미지 생성, 텍스트+이미지
GPT Image 2	fal-ai/gpt-image-2	OpenAI 최신 이미지 모델
Ideogram V3	fal-ai/ideogram/v3	강한 프롬프트 준수 + 타이포그래피
Recraft V4 Pro	fal-ai/recraft/v4/pro	벡터 스타일, 그래픽 디자인
Qwen Image	fal-ai/qwen-image	Alibaba 멀티모달

목록은 계속 바뀔 수 있습니다. hermes tools → Image Generation에서 현재 사용 가능한 목록을 확인하세요.

---

구성 참조

대부분의 사용자는 이 설정을 직접 만질 필요가 없습니다. hermes model과 hermes tools가 대부분의 워크플로를 대화식으로 처리합니다. 이 섹션은 config.yaml을 직접 작성하거나 스크립트로 설정할 때 참고하세요.

도구별 use_gateway 플래그

각 도구의 설정 블록은 use_gateway 불리언을 사용합니다:

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

우선순위: use_gateway: true이면 .env에 직접 키가 있더라도 Nous를 통해 라우팅합니다. use_gateway: false이거나 값이 없으면 직접 키가 있을 때 직접 키를 사용하고, 직접 키가 없을 때만 게이트웨이로 폴백합니다.

게이트웨이 비활성화

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

hermes tools는 비게이트웨이 제공자를 선택할 때 이 플래그를 자동으로 해제하므로, 보통은 사용자가 직접 수정할 일이 없습니다.

셀프 호스팅 게이트웨이(고급)

자체 Nous 호환 게이트웨이를 운영 중이라면 ~/.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

이 옵션들은 맞춤 인프라 설정(기업 배포, 개발 환경)을 위한 것입니다. 일반 구독자는 설정할 필요가 없습니다.

자주 묻는 질문

텔레그램 / 디스코드 / 다른 메시징 게이트웨이와 작동하나요?

네. Tool Gateway는 CLI가 아니라 도구 실행 계층에서 동작합니다. 도구를 호출할 수 있는 모든 인터페이스, 즉 CLI, Telegram, Discord, Slack, IRC, Teams, API 서버 등에서 투명하게 사용할 수 있습니다.

내 구독이 만료되면 어떻게 되나요?

게이트웨이를 통해 라우팅된 도구는 구독을 갱신하거나 hermes tools로 직접 API 키를 지정할 때까지 작동하지 않습니다. Hermes는 Portal을 안내하는 명확한 오류를 표시합니다.

도구별 사용량이나 비용을 확인할 수 있나요?

네. Nous Portal 대시보드에서 도구별 사용량을 분류해 어떤 항목이 비용을 발생시키는지 확인할 수 있습니다.

Modal(서버리스 터미널)이 포함되어 있나요?

Modal은 기본 Tool Gateway 번들에 포함되지 않고, Nous 구독을 통해 선택적 추가 기능으로 제공됩니다. 셸 실행용 원격 샌드박스가 필요할 때 hermes setup terminal 또는 config.yaml에서 직접 구성할 수 있습니다.

게이트웨이를 활성화할 때 기존 API 키를 삭제해야 하나요?

아니요. 기존 키는 .env에 그대로 두세요. use_gateway: true일 때 Hermes는 직접 키를 건너뛰고 게이트웨이를 사용합니다. 플래그를 다시 false로 바꾸면 직접 키가 다시 사용됩니다. 게이트웨이는 잠금 장치가 아닙니다.