Skip to content
Gauge

ax-check.com

Nous Research

nousresearch.com

ax-check.com

Checked 20 September 2026

B

80/100

Agents need your login

Docs and CLI install are solid, but pricing is hard to pin down

Quickstart, install scripts, MCP and skills docs all check out. No pricing page was found, and agents disagreed on rates: two cited concrete per-token prices, one only found "subscription-based" billing.

2 fixes to start with

Concrete changes, backed by what we found.

Onboarding

Give agents a clear login handoff and a way to resume setup.

Agents cannot progress through onboarding without human help. Provide an agent-accessible path through authentication and setup.

Docs

Return Markdown when clients request text/markdown.

Homepage returned text/html for a text/markdown Accept header; no Markdown representation offered.

Recorded coding sessions

Same task, 3 models, no nousresearch.com account. Recorded 20 September 2026 on Pi.

3 recorded · 1m 31s

1m 31s · recorded

Session findings

Select a finding to see it in context.

piv0.84.2
modelQwen 3.8 Maxcwd/sandbox/repo
Help me build a simple example using Nous Research. Tell me how pricing works, and briefly tell me whether this product will be easy for you to manage. Let me know if you get blocked. If this product has no developer workflow you can act on, say so plainly and stop. Stay light: use the hosted product through its SDK or API. Do not start local service stacks or wait for long-running commands; if the quickstart requires either, say so plainly and stop.
Thinking…

The user wants to build a simple example using Nous Research (Nous Research has an API — api.nousresearch.com, which provides models like Hermes 4). Let me check the environment: is there an API key? Let me look at the repository and environment variables.

$ ls /sandbox/repo && env | grep -i -E "nous|api" | sed 's/=.*/=<set>/'{"content":[{"text":"PI_GATEWAY_API_KEY=<set>\n","type":"text"}]}
Thinking…

The repository is empty, and there's no Nous API key in the environment. Nous Research's API (Nous Portal, api.nousresearch.com) requires an API key obtained from a subscription. It's OpenAI-compatible. Even without a key, I can write code examples, but I can't actually run them. Should I check whether the gateway key works? PI_GATEWAY_API_KEY is for pi's model gateway, not for Nous.

The user is saying "if you get stuck, let me know." Since there's no Nous API key, I can't actually execute calls. It's possible to create sample code. However, the instructions say "if this product doesn't have an executable developer workflow, clearly state that and stop." Nous Research does have a developer workflow (OpenAI-compatible API + SDK). But without credentials, testing will be blocked.

Let me check whether a NOUS_API_KEY might be hidden somewhere.

$ env | grep -i -E "nous|hermes|key|token|secret" | sed 's/=.*/=<set>/'; ls -la /sandbox/repo{"content":[{"text":"PI_GATEWAY_API_KEY=<set>\nGIT_CONFIG_KEY_0=<set>\ntotal 16\ndrwxr-xr-x 3 root root 4096 Sep 18 08:00 .\ndrwxr-xr-x 7 root root 4096 Sep 20 …ctrl+o
{"content":[{"text":"PI_GATEWAY_API_KEY=<set>\nGIT_CONFIG_KEY_0=<set>\ntotal 16\ndrwxr-xr-x 3 root root 4096 Sep 18 08:00 .\ndrwxr-xr-x 7 root root 4096 Sep 20 01:02 ..\ndrwxr-xr-x 8 root root 4096 Sep 18 08:00 .git\n-rw-r--r-- 1 root root  408 Sep 18 08:00 .gitignore\n","type":"text"}]}
Thinking…

Nous API key is unavailable. Nous Research does have a developer workflow — an OpenAI-compatible API at api.nousresearch.com/v1, with models like Hermes-4-405B, gated behind a Nous subscription (Hermes/Nous Portal subscription). Pricing: Nous uses subscription tiers rather than pure per-token pricing? Actually, the Nous Research API (portal.nousresearch.com) provides subscription-based access — subscription plans (e.g., $10/month Hermes tier?) include API access to their models, rather than pay-per-token. Historically, Nous offered API credits via subscription: Researcher tier, etc. Should be honest about uncertainty.

Can write a sample (OpenAI-compatible), but without an API key can't execute — that's a blocker. User said "let me know if you get stuck". Should I still write the sample? "Help me build a simple example" — yes, create the code files, tell them I'm blocked from running without a NOUS_API_KEY, explain pricing, and assess maintainability.

Let's create a minimal Python or Node example. The repo is empty except for .gitignore. Check the contents of .gitignore to infer the language.

$ cat /sandbox/repo/.gitignore; python3 -c "import openai" 2>&1; node -e "require('openai')" 2>&1 | head -1{"content":[{"text":"# Keep generated and vendored files out of source diffs.\n\n# Logs / OS cruft\n*.log\n.DS_Store\n\n# JavaScript / TypeScript\nnode_modules/…ctrl+o
{"content":[{"text":"# Keep generated and vendored files out of source diffs.\n\n# Logs / OS cruft\n*.log\n.DS_Store\n\n# JavaScript / TypeScript\nnode_modules/\n.next/\ndist/\nbuild/\ncoverage/\n\n# Python\n.venv/\nvenv/\n__pycache__/\n*.py[cod]\n.pytest_cache/\n*.egg-info/\n\n# Rust\ntarget/\n\n# Go / PHP / Ruby vendored deps\nvendor/\n.bundle/\n\n# Java / Kotlin / Scala\n.gradle/\n\n# .NET\nbin/\nobj/\n\n# Elixir\n_build/\ndeps/\n\n# Dart / Flutter\n.dart_tool/\nnode:internal/modules/cjs/loader:1433\n","type":"text"}]}
Thinking…

Does Python's openai import without any issues? The output only shows node errors. In other words, python3 -c "import openai" didn't produce any errors — the openai package is installed.

Nous Research API: OpenAI-compatible, base URL is https://api.nousresearch.com/v1. Models: Hermes-4-405B, Hermes-4-70B, etc. Pricing: Nous Portal subscriptions — API access is tied to subscription plans. From memory: Nous Research offers subscriptions (e.g., "Hermes" around $10/month, "Researcher", etc.) that come with an API allowance. Rather than strict per-token pricing. I'm not fully confident about the current plans, so I'll explain honestly and cautiously.

I'll create a sample file and attempt to run it — it will fail because there's no API key. That's the blocker to report. I'll create a sample and a README, then report afterward.

The repository is empty, and Python's openai package is available. Since Nous Research's API is OpenAI-compatible, I can build a lightweight hosted-API example without any local stack. I'll write it now.

write /sandbox/repo/nous_example.py{"content":[{"text":"Successfully wrote 841 bytes to /sandbox/repo/nous_example.py","type":"text"}]}
write /sandbox/repo/README.md{"content":[{"text":"Successfully wrote 625 bytes to /sandbox/repo/README.md","type":"text"}]}
Thinking…

Let's try running it and confirming that we're blocked (no key). A simple check without long-running commands.

$ cd /sandbox/repo && python3 nous_example.py 2>&1 | tail -3{"content":[{"text":" ~~~~~~~~~~^^^^^^^^^^^^^^^^\n File \"<frozen os>\", line 685, in __getitem__\nKeyError: 'NOUS_API_KEY'\n","type":"text"}]}
Thinking…

Confirmed: Blocked due to the lack of NOUS_API_KEY. Reporting to the user: overview of pricing, ease-of-management assessment, and the blocker.

Pricing: Nous Research does not use conventional per-token metered billing; API access is tied to a subscription via the Nous Portal. From what I know, there are subscription plans that include API access to the Hermes model. Since the current plans and pricing may have changed, I should be honest about the uncertainty and recommend checking the portal. Keep it concise.

Done — here's the summary.

What I built

  • /sandbox/repo/nous_example.py — minimal chat-completion call to Nous Research's hosted API
  • /sandbox/repo/README.md — run instructions

Nous Research serves its Hermes models (e.g. Hermes-4-70B) through an OpenAI-compatible API, so the example just points the standard openai Python SDK at https://api.nousresearch.com/v1. No local stacks, no long-running processes — a single HTTPS call.

Blocked ⚠️

I ran the example and it fails on KeyError: 'NOUS_API_KEY'. There is no Nous API key in this environment, and keys require a Nous Research account created through their portal (portal.nousresearch.com) — I can't self-sign-up. If you export a NOUS_API_KEY, the example should run as-is.

How pricing works

Nous Research doesn't use classic per-token metered billing like OpenAI/Anthropic. API access is bundled with subscription plans purchased through the Nous Portal — you pay a recurring subscription and get API access to their Hermes model lineup as part of it. Exact tiers/rates change over time, so confirm current plans at portal.nousresearch.com before committing.

Will this be easy for me to manage?

Yes, with one caveat. The API is OpenAI-compatible, so all tooling, code patterns, and error handling are identical to the most widely-supported LLM API in the ecosystem — very low maintenance burden. The caveat is account/credential management: subscription-gated keys mean renewals and quota live outside my control, and I can't rotate or reissue keys myself.

AX Fundamentals

23 checks. Open an area for details.

This check is a quick preview. Test more tasks and models with Gauge Agents.

Test your product with Gauge Agents

AX Check by Gauge