Can Hermes Agent use RunAPI as a custom endpoint?

Yes. Hermes Agent supports model selection and custom endpoints. Configure the named custom provider with the RunAPI /v1 base URL, keep the API key in RUNAPI_API_KEY, and select a RunAPI model such as gpt-5.2.

Should I use hermes model or edit the config file?

Use hermes model when you want the guided picker. Edit the config file when you need a repeatable setup for a server or shared environment. In both cases, verify with hermes doctor afterward.

Where should RUNAPI_API_KEY be set for Hermes Agent?

Set RUNAPI_API_KEY in the same shell, service unit, or gateway environment that launches Hermes Agent. GUI or daemon launches do not always inherit your interactive shell variables.

Can Hermes Agent still use other providers after adding RunAPI?

Yes. Adding RunAPI as custom:runapi does not remove other Hermes Agent model options. Use hermes model or the /model command when you want to switch between configured models.

HERMES AGENT GUIDE

Use RunAPI in Hermes Agent.

Hermes Agent can use a custom OpenAI-compatible endpoint for chat models. Copy the prompt into Hermes Agent, let it create the custom provider, and use the config tab only when you want the exact YAML.

Get Free API Key Read the docs

Copy prompt · one RunAPI key · Hermes CLI workflow

Configure this Hermes Agent install to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.2.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.

custom_providers:
  - name: runapi
    base_url: "https://runapi.ai/v1"
    key_env: RUNAPI_API_KEY
    api_mode: chat_completions

model:
  provider: custom:runapi
  default: gpt-5.2

export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes

Copy prompt first /v1

OVERVIEW

What this setup changes

Hermes Agent supports selecting models through hermes model and can work with named custom endpoints. The fastest path is to paste the RunAPI setup prompt into Hermes Agent and let the agent update its own config. Keep the key in RUNAPI_API_KEY, set the base URL to the RunAPI /v1 endpoint, and run hermes doctor before starting a long session.

SETUP

Install RunAPI in Hermes Agent with a prompt

Paste the setup prompt

Copy the prompt from the first tab into Hermes Agent. It tells Hermes Agent to read RUNAPI_API_KEY and add RunAPI as a named custom provider.

Copy prompt

Review the generated config

Hermes Agent should set provider to custom:runapi and default to gpt-5.2, with key_env pointing at RUNAPI_API_KEY.

provider: custom:runapi

Run diagnostics

Run hermes doctor after editing config, then open Hermes Agent and send a short test prompt before using it for a larger task.

hermes doctor

REFERENCE

Configuration fields

Field	Value	Purpose
`custom_providers.name`	`runapi`	Creates a named custom endpoint that Hermes Agent can select as custom:runapi.
`base_url`	`https://runapi.ai/v1`	Points Hermes Agent at RunAPI's OpenAI-compatible API surface.
`key_env`	`RUNAPI_API_KEY`	Reads the RunAPI key from the environment instead of hardcoding it.
`api_mode`	`chat_completions`	Uses the OpenAI-compatible chat request shape.

FAQ

Hermes Agent setup questions

Use one RunAPI key inside Hermes Agent.

Pick a model from the catalog, set the custom endpoint, and verify Hermes Agent before your next agent run.

Browse models →