Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · LLMReleased 2025-08-26

How to Use Hermes 4 405B in Windsurf

Hermes 4 405B suits math, code analysis, structured JSON, and character-driven writing. It scores higher than Hermes 4 70B on Nous Research's AIME 2025 and LiveCodeBench tests with reasoning enabled.

Prompts to try with Hermes 4 405B in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use Hermes 4 405B with reasoning enabled to review the parser and its tests in this project. Identify three concrete edge cases, propose a minimal patch, and explain how to test each case.

Hermes 4 405BWindsurf
Try asking
  • Use Hermes 4 405B to compare the implementation with the project's written specification. Return a table of mismatches with file references and suggested corrections.

  • Use Hermes 4 405B to repair the malformed JSON fixtures against the project's schema. Preserve existing values where possible and flag ambiguous repairs for review.

  • Use Hermes 4 405B with reasoning enabled to analyze this project's scheduling algorithm. Check boundary conditions and propose tests for empty input, overlapping intervals, and equal timestamps.

  • Use Hermes 4 405B to draft a contributor guide from the README and public interfaces. Keep it under 800 words and flag details the project does not document.

How to set up Hermes 4 405B in Windsurf

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Hermes 4 405B

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "openrouter",
        "model": "nousresearch/hermes-4-405b",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Windsurf finds Hermes 4 405B on Spiral, shows the price and runs it.

Hermes 4 405B providers and prices

Spiral runs Hermes 4 405B through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Nous: Hermes 4 405B
nousresearch/hermes-4-405b

Settings you can ask for

Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Top ka whole number from 0
Top p0 to 1
Logprobson or off
Max tokens1 to 117964

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Presence penalty-2 to 2
Frequency penalty-2 to 2
Repetition penalty0 to 2

Every API field of Nous: Hermes 4 405B is on its tool page: open its card above.

What can you do with Hermes 4 405B in Windsurf?

Turn project code and specifications into focused reviews, proposed fixes, and structured records with Hermes 4. Give it bounded analysis tasks, consistent with Nous Research's caution about rapid tool-calling loops.

Review an algorithm

Provide a function, its intended behavior, and failing examples. Ask for likely defects, a proposed correction, and tests that distinguish the corrected behavior.

Check a calculation

Supply the quantities, units, assumptions, and proposed result. Request an independent calculation with a short explanation and a list of missing information.

Extract records from text

Turn supplied support messages or meeting notes into JSON matching a defined schema. Specify required keys and use null for information the source does not contain.

Repair malformed JSON

Provide a broken JSON object and its intended schema. Request corrected JSON plus a separate account of any ambiguous values that require review.

Draft character dialogue

Define each character's motives, knowledge, and speaking style. Request a scene that advances a specific conflict while keeping the voices distinct.

Develop a long-form draft

Supply an outline, audience, source material, and target length. Draft one section at a time, then review continuity and repeated points.

Explain a science concept

Ask for an explanation at a named reading level, followed by worked examples and practice questions. Supply reference material when factual precision matters.

Compare written proposals

Provide the proposals and evaluation criteria. Request a comparison that separates stated evidence, assumptions, and unanswered questions.

Questions about Hermes 4 405B in Windsurf

Can Windsurf use Hermes 4 405B?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Hermes 4 405B like any built-in tool.

How much does Hermes 4 405B cost in Windsurf?

Up to $0.01602 per run at the default inputs. $1.30 per 1M input tokens, $3.90 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

Do I need an OpenRouter account to use Hermes 4 405B in Windsurf?

No. Spiral runs Hermes 4 405B on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Hermes 4 405B in Windsurf?

About two minutes: add the server, then sign in, then check it.

Does Windsurf wait while Hermes 4 405B runs?

Hermes 4 405B runs in the background. Windsurf starts the run, checks on it and gives you the text, json when it's ready.

What is Hermes 4 good at?

Nous highlights math, science, instruction following, structured JSON, roleplay, and long-form writing. Useful starting tasks include explaining a calculation, extracting records into a schema, and drafting dialogue with a defined character voice.

When should I use reasoning?

Use reasoning for difficult math and code problems. In Nous Research's tests, Hermes 4 405B scored 78.1 on AIME 2025 with reasoning enabled, compared with 10.6 without it.

Can Hermes 4 produce structured JSON?

Yes. It was trained to follow JSON schemas and repair malformed objects. Supply the schema, define how missing values should appear, and validate the result before using it.

What sampling settings should I start with?

Nous recommends temperature 0.6, top_p 0.95, and top_k 20. Use these as a baseline when comparing prompts on the same tasks.

How much text can Hermes 4 405B handle?

Its published configuration specifies 131,072 token positions. That is configured context capacity, not a guarantee that it will write a response that long.

Get started

Start using Hermes 4 405B in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options