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.
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:- 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.