Skip to content

Documentation Hermes Agent

Tool integrations

Hermes Agent

Configure a custom Chat Completions endpoint in Hermes.

Before you start#

Install Hermes Agent and prepare a Morfac API key from the console.

Desktop#

  1. Open Settings → Providers → Custom Endpoints. If initial setup asks for a provider, you can select it later.
  2. Add an endpoint named Morfac. Set Endpoint URL to https://api.dev.morphfactory.io/v1, Default Model to motif/motif-3, and API Key to your Morfac key. Leave Context on Auto.
  3. Use Test, then Save. Select Use for the endpoint. Enable Use for new chats only if you want it as the default.
  4. Open a new conversation and ask a short text question.

Terminal#

Open the model selector:

Shell
hermes model

Select Custom endpoint (enter URL manually). Enter https://api.dev.morphfactory.io/v1, your Morfac key and motif/motif-3. If an API compatibility mode is requested, choose Chat Completions by name; menu numbers may change. Leave optional context and display-name fields at their defaults unless you have verified values.

For first-time setup, start with hermes setup. Launch hermes and ask a short text question. Check the official setup notes if your version has different prompts.

Troubleshooting#

Check that the URL ends in /v1 and that this endpoint is selected for the current chat. See Troubleshooting for API errors.