Skip to main content
Hermes Agent is an open-source self-improving AI agent framework by Nous Research.

​
Prerequisites

  • An active MiniMax M Plan subscription. OAuth sign-in does not require an M Plan API key; the other setup options below do.
  • A computer with terminal access (macOS, Linux, or Windows with WSL2)
Hermes Agent

​
Install Hermes Agent

Hermes Agent is an open-source, self-improving AI agent built by Nous Research. It features persistent cross-session memory, a built-in learning loop, 40+ integrated tools, and multi-platform access (CLI, Telegram, Discord, Slack, WhatsApp). Run the one-line installer in your terminal:
Verify the installation:
For more information, refer to the Hermes Agent documentation.

​
Configure MiniMax M Plan

Run the model selector:
  1. Select MiniMax from the provider list.
Select MiniMax in the Hermes provider list
  1. Select MiniMax (OAuth). Hermes opens the MiniMax sign-in page; sign in and authorize access. No M Plan API key is needed.
Select MiniMax OAuth in Hermes
  1. In the model list, choose Enter custom model name and enter MiniMax-M3.1-Flash if it is not listed by your Hermes version.
This OAuth option uses the international MiniMax endpoint. Check your account’s access to the selected model before relying on it for work.After selecting the model, you can edit ~/.hermes/config.yaml and set context_length: 1000000 (1M context) under the existing model: section. Keep its other fields.
OAuth sign-in does not use an M Plan API key. For key-based setup, view your M Plan API key in Plan Details. M Plan API keys are different from pay-as-you-go API Keys.

​
Start using Hermes Agent

Run hermes to start talking with Hermes Agent powered by the latest MiniMax M-series models.
Hermes Agent supports persistent memory and reusable skills across sessions.

​
Reasoning effort

Thinking is always enabled for MiniMax-M3.1-Flash and cannot be disabled. Supported levels are low, medium, high, xhigh, and max; do not use none or minimal. When selecting a level through /reasoning, use the options supported by your Hermes Agent version.