Hermes Agent integration
Set up Hermes Agent with ScriptEngine.
Install the terminal or Desktop interface, add one custom OpenAI-compatible endpoint, and run Hermes with a ScriptEngine API key.
Choose an interface
Same agent. Two ways in.
When they use the same OS environment and Hermes profile, Hermes CLI and Hermes Desktop share the same runtime, configuration, API keys, sessions, skills and memory. Pick the interface you prefer; you can switch later without configuring ScriptEngine twice.
Hermes CLI
Use the official installer, configure ScriptEngine through hermes model, verify the endpoint, and start a terminal session.
Hermes Desktop
Install the native Hermes GUI, configure the shared provider once, then chat through the Desktop interface.
Open the Desktop tutorial →Connection contract
Three values are all Hermes needs.
ScriptEngine implements the OpenAI-compatible chat-completions interface Hermes expects from a custom provider.
- Base URL
https://scriptengine.org/v1- Authentication
- Your private ScriptEngine key beginning with
sk-se-. Never publish or paste the real value into a tutorial, repository or chat. - Model
- A currently available model ID returned by ScriptEngine’s authenticated model discovery. The catalog can change, so select rather than guess.
- Provider type
- Choose the provider whose label begins Custom endpoint—not OpenAI, OpenRouter or Nous Portal. The explanatory text in parentheses varies between Hermes releases.
The short version
Install, connect, verify.
The detailed tutorials include platform commands and troubleshooting. The integration itself follows the same sequence in either interface.
-
01
Install Hermes
Use Nous Research’s official Desktop installer or terminal installation script for your operating system.
-
02
Add ScriptEngine
In Desktop, open Settings → Providers → Custom Endpoints. In the CLI, run
hermes model. Enter the same ScriptEngine base URL, key and discovered model ID. -
03
Start a fresh chat
Ask Hermes for a one-line connection reply. A successful answer confirms that installation, authentication and model routing all work.
Before you begin
Common setup questions.
Is Hermes Agent made by ScriptEngine?
No. Hermes Agent is an open-source project developed by Nous Research. ScriptEngine is a separate OpenAI-compatible API provider that can be configured as a custom endpoint.
Should the base URL include /chat/completions?
No. Enter exactly https://scriptengine.org/v1. Hermes appends the endpoint path required for each request.
Can the CLI and Desktop app share one setup?
Yes—when both use the same OS environment and Hermes profile. Native Windows and WSL2 use separate Hermes homes, so they require separate configuration.
Where do I get the API key?
Create a ScriptEngine account, purchase or add credits, and store the full sk-se-… key when it is shown. The full secret is displayed once.
Source notes
Built from current official documentation.
Hermes commands and platform details on these pages are based on Nous Research’s current documentation. ScriptEngine connection values are based on the live public API configuration checked on July 29, 2026.