> ## Documentation Index
> Fetch the complete documentation index at: https://platform.minimax.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Use the latest MiniMax M-series models in Hermes Agent for autonomous AI-powered development.

<div style={{background:"#fffbeb",borderLeft:"4px solid #d97706",padding:"12px 16px",borderRadius:"6px",margin:"16px 0"}}>[**Hermes Agent**](https://github.com/NousResearch/hermes-agent) is an open-source self-improving AI agent framework by Nous Research.</div>

## Prerequisites

* A MiniMax [Subscription Key](https://platform.minimax.io/user-center/payment/token-plan) with Token Plan or Credits access
* A computer with terminal access (macOS, Linux, or Windows with WSL2)

***

<img src="https://mintcdn.com/minimax-cac98058/GOJmMenSBGK8R2VS/images/hermes-agent-banner.png?fit=max&auto=format&n=GOJmMenSBGK8R2VS&q=85&s=27f45435661547706c518b5a4203b83b" alt="Hermes Agent" style={{borderRadius: '8px', marginTop: '12px', maxWidth: '100%'}} width="1145" height="196" data-path="images/hermes-agent-banner.png" />

## Install Hermes Agent

[Hermes Agent](https://github.com/NousResearch/hermes-agent) is an open-source, self-improving AI agent built by [Nous Research](https://nousresearch.com). 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:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

Verify the installation:

```bash theme={null}
hermes doctor
```

For more information, refer to the [Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs/).

## Configure MiniMax Token Plan

<Tabs sync={false}>
  <Tab title="Option 1: One-click setup wizard">
    When using the one-click setup wizard, you can skip the manual installation above and run:

    ```bash theme={null}
    npx -y mmx-cli@latest agent setup
    ```

    Select **Hermes Agent**. If it is missing, keep Hermes Agent selected in the second multi-select. The wizard runs the official installer's non-interactive core CLI stages, skips optional flows such as `setup` and `gateway`, and checks `hermes --version`. It then updates `~/.hermes/config.yaml` and `~/.hermes/.env`.

    See [One-click setup wizard](/docs/token-plan/agent-setup) for command options and backup behavior.
  </Tab>

  <Tab title="Option 2: Manual setup">
    Hermes Agent has built-in support for MiniMax as a provider. Run the model selector:

    ```bash theme={null}
    hermes model
    ```

    1. Select **"MiniMax (global endpoint)"** from the provider list.

    <img src="https://mintcdn.com/minimax-cac98058/GOJmMenSBGK8R2VS/images/hermes-agent-provider-global.png?fit=max&auto=format&n=GOJmMenSBGK8R2VS&q=85&s=907f0d4bb6b2a77d1efc49518f75cb47" alt="Select MiniMax (global endpoint)" style={{borderRadius: '8px', marginTop: '12px', maxWidth: '100%'}} width="2004" height="1490" data-path="images/hermes-agent-provider-global.png" />

    2. When prompted, enter your **Subscription Key** obtained from the [MiniMax Token Plan page](https://platform.minimax.io/user-center/payment/token-plan).

    <img src="https://mintcdn.com/minimax-cac98058/GOJmMenSBGK8R2VS/images/hermes-agent-apikey-global.png?fit=max&auto=format&n=GOJmMenSBGK8R2VS&q=85&s=d6ae4ec68a00826fb5513a1ed2bd4111" alt="Enter MiniMax API Key" style={{borderRadius: '8px', marginTop: '12px', maxWidth: '100%'}} width="1232" height="230" data-path="images/hermes-agent-apikey-global.png" />

    3. Select **MiniMax-M3** as the model.
  </Tab>
</Tabs>

<Info>
  Don't have resources yet? View your Subscription Key on the [Token Plan page](https://platform.minimax.io/user-center/payment/token-plan), then buy a Token Plan subscription or Credits, or use resources assigned by your Team. Subscription Keys are different from pay-as-you-go API Keys.
</Info>

## Start Using Hermes Agent

Run `hermes` to start talking with Hermes Agent powered by the latest MiniMax M-series models.

<Tip>
  Hermes Agent's persistent memory and self-improving skills system means it gets better the more you use it — your coding patterns, project context, and preferences are remembered across sessions automatically.
</Tip>

## Toggle thinking

Toggle thinking at runtime with `/reasoning`: `none` turns it off, any other level (minimal/low/medium/high/xhigh) turns it on.