Skip to content
Development
Skill

/use-nous-research-services

Use and troubleshoot Nous Research services with Hermes Agent, including Nous Portal inference, Tool Gateway backends, Nous Chat, subscription proxy, and Hermes Cloud hosted deployment.

From plugin
socket
9200 skills5 MCP

Claude Code

$ npx -y skills add gaelic-ghost/socket --skill use-nous-research-services --agent claude-code

SKILL.md

use-nous-research-services.SKILL.md
name: use-nous-research-services
description: Use and troubleshoot Nous Research services with Hermes Agent, including Nous Portal inference, Tool Gateway backends, Nous Chat, subscription proxy, and Hermes Cloud hosted deployment.
metadata:
  hermes:
    category: agent-portability
    tags: [nous, portal, tool-gateway, cloud, inference]

Use Nous Research Services

Identify the Nous product before changing authentication or routing.

Product Map

| Product | Job | | --- | --- | | Nous Portal | OAuth-authenticated subscription and inference provider for Hermes and Nous services | | Nous Tool Gateway | Per-tool hosted backends selected inside Hermes | | Nous Chat | Web chat using the Portal account and model catalog | | Subscription proxy | Local OpenAI-compatible proxy that lets other apps use Hermes-managed subscription credentials | | Hermes Cloud | Portal-hosted Hermes deployment surface; inspect the live Portal and current official docs before claiming plans, regions, sizes, persistence, or lifecycle behavior |

Do not call the messaging gateway or TUI gateway “Nous Gateway.”

Configure Portal Deliberately

  • For a fresh Hermes setup, use `hermes setup --portal` when the user wants both Portal inference and the managed tool onboarding path.
  • Current official onboarding describes one Portal OAuth for a 300+ model

catalog plus the four standard Tool Gateway routes: web search, image generation, text-to-speech, and browser automation. Treat exact counts and entitlements as live claims and re-check them before quoting.

  • For an existing install, use `hermes model` to add Nous without erasing other providers.
  • Use `/model` only to switch among already configured choices inside a session.
  • Use `hermes portal info` and `hermes portal tools` to inspect auth and routing.
  • Treat the refresh token in the Hermes auth store as a secret.
  • Keep Portal inference selection separate from per-tool Tool Gateway selection.

Configure Tool Gateway Per Tool

Use `hermes tools` to choose Nous-hosted backends individually. A user may mix Nous-hosted web or image tools with their own browser, TTS, or other provider. Verify the active route instead of inferring it from Portal login alone.

Current documented categories include web search/extract, image generation, text-to-speech, and cloud browser automation. An optional cloud terminal sandbox is a separate entitlement, not one of the four standard onboarding routes. Availability, free pools, add-ons, partners, models, and pricing can change; read the live Portal or official docs for current entitlement claims.

Use the Subscription Proxy Carefully

The proxy is a local credential-forwarding service for OpenAI-compatible clients. It is not the Hermes API server:

  • subscription proxy: forwards supported provider endpoints using Hermes-managed OAuth;
  • Hermes API server: runs the agent loop and its tools behind an OpenAI-compatible interface.

Keep the proxy on localhost unless the user has explicitly designed network authentication. Do not treat an arbitrary client bearer as meaningful protection when the proxy accepts placeholder bearer values and attaches the real upstream credential.

Handle Hermes Cloud as a Live Hosted Surface

Hermes Cloud is newer and more likely to change than the open-source CLI contract. Before creating, resizing, stopping, deleting, or billing a deployment:

1. Inspect the current official Portal UI or current official documentation. 2. Record the available model, server size, persistence, region, pricing, and lifecycle choices shown now. 3. Distinguish the hosted Hermes instance from a self-hosted VM, Modal terminal backend, Daytona backend, or cloud terminal tool. 4. Ask before any billable deployment or destructive lifecycle action. 5. Verify access, profile state, gateway reachability, persistence, and shutdown behavior after changes.

Do not infer undocumented cloud controls from announcements or screenshots.

Verification

Return the active provider, selected model, each affected tool route, entitlement evidence, local secret location class, and whether any hosted resource or billing state changed.

Read [references/nous-services-map.md](references/nous-services-map.md) for the detailed distinctions, commands, risks, and authoritative sources.

Read more
@gaelic-ghost
Ships withsocket

Stuff for Agents on macOS Promo audio: Socket Codex Marketplace Promo

9200 skills5 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
9
Star history of gaelic-ghost/socket on GitHub, a chart by star-history.com

Other skills on socket.

orchestrate-agent-work

orchestrate-agent-work

Coordinate bounded worker tasks with a launch envelope, report-back, escalation, and synthesis contract. Use before spawning,…

@gaelic-ghost@gaelic-ghostInstall Skill

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills11d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc12d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react1d252k
@facebook@facebookInstall Skill

Questions about use-nous-research-services.

Which coding agents can use use-nous-research-services?
use-nous-research-services installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.