Skip to main content
Hermes is an agent tool from Nous Research. It connects to a custom OpenAI-compatible endpoint, so you can use Novita LLM models in Hermes for local agent workflows.

Prerequisites

Prepare the following values:
  • API key: Create or copy an API key from Key Management.
  • Base URL: https://api.novita.ai/openai/v1
  • Model ID: Copy the model ID you want to use from the Model Hub, such as deepseek/deepseek-v4.1-flash.
Hermes stores endpoint and API key settings locally. Do not commit any generated configuration that contains your API key.

Install Hermes

Hermes offers terminal and desktop installation options. Choose the one that fits your workflow.

Linux / macOS / WSL2

Windows PowerShell

Desktop

You can also download Hermes Desktop from:

Configure the Novita endpoint

After installation, run the Hermes setup flow. The exact command may vary by Hermes version, so follow the terminal prompts from your installed version. During setup, use the following choices and values:
1

Select Custom endpoint

Select Custom endpoint or the option that lets you enter a provider URL manually.
2

Set the Base URL

Set the Base URL to https://api.novita.ai/openai/v1.
3

Enter your Novita API key

Enter your Novita API key.
4

Keep the default API type

For API type, keep the default auto-detection option. If you need to choose manually, select the OpenAI-compatible or Chat Completions mode.
5

Select or enter a model ID

Select a model from the list, or enter a Novita model ID manually, such as deepseek/deepseek-v4.1-flash.
6

Set max tokens

Set max tokens based on the model context length. If you are not sure, keep the default or auto-detected value.
7

Name the model configuration

Give the model configuration a recognizable name, such as novita-deepseek-v4.1-flash.
8

Choose the Local runtime

If you only want to run Hermes locally, choose the default Local runtime.
9

Skip integration channels

If you do not need channels such as Telegram, Slack, or Matrix, skip integration channels.

Reload your shell

If Hermes asks you to reload your shell, run:

Start Hermes

Start Hermes from your terminal:
Send a test message, for example:
If the request fails, check that:
  • Your API key is correct.
  • The Base URL is https://api.novita.ai/openai/v1.
  • The model ID matches the one shown in Novita’s Model Hub.
  • The selected API type is compatible with an OpenAI-compatible endpoint.
Last modified on November 11, 2026