Last updated September 14, 2026

Nous Research in Codex — Hermes Models | Codex Router

Nous Research in Codex means adding models from the Nous Portal inference API to the Codex model picker through Codex Router. Provider id nousresearch points at https://inference-api.nousresearch.com/v1, and Nous Portal API keys authenticate the same endpoint the Hermes agent uses.

What the Nous route is

The nousresearch provider is an ordinary API-key provider with a live-reviewed registry. A Nous Portal key from portal.nousresearch.com authenticates inference; the router stores it and sends it only to the Nous endpoint for turns that select a Nous model.

Enable Nous Research

Install Codex Router first (see the install guide), then store the Portal key and enable the provider:

Create a Nous Portal API key.
Store it through the hidden prompt.
Enable the provider and restart Codex.

./bin/model-router codex provider-key nousresearch set
./bin/model-router codex providers enable nousresearch

On Windows use ./model-router.ps1 codex with the same commands. Then fully quit Codex, reopen it, and create a new task.

Registry versus live catalog

The checked-in registry lists 28 models, including Hermes 4 and free portal tiers. That is a reviewed starting set, not the whole catalog: the Portal exposes roughly 372 models in total. Curate the rest from the account’s live catalog:

./bin/curate-models nousresearch

Curation lists what the account can currently see and stores the ones you toggle in protected state. Curated entries use the context window, image support and reasoning efforts you provide, falling back to what the catalog advertises.

Verify the integration

./bin/model-router codex doctor
./bin/model-router codex providers
./bin/test-model 'nousresearch/MODEL_ID' --live --yes

The provider must report SHOW and ready. If entries are missing, see models missing from the picker.

The Hermes client integration

There is a separate client integration for the Hermes Agent. The Hermes Agent client can be published to from the Harness page:

./bin/control client-setup hermes

That route is different from the nousresearch provider route described here. The provider adds Nous models to Codex’s picker; the client setup configures the Hermes agent client itself.

Provider policy

Nous Research may restrict or block proxy traffic. Routing its models through Codex Router is at your own risk; check Nous Research’s terms before relying on it.

FAQ

What is the Nous Research route in Codex? It is Codex Router’s nousresearch provider, which routes models from the Nous Portal inference API into the Codex picker using a Nous Portal API key.

Does the registry include every Nous model? No. The checked-in registry lists 28 models including Hermes 4 and free portal tiers, but that is not the full roughly 372-model catalog. Curate more with ./bin/curate-models nousresearch.

Is the Hermes client the same as this provider route? No. The Hermes Agent client integration is published from the Harness page with ./bin/control client-setup hermes, which is separate from the nousresearch provider route.