MiniMax OAuth Integration

Think of API keys like a house key—they work, but you have to keep track of them, and if you lose one, you’re locked out. OAuth is more like a hotel keycard: it’s temporary, tied to your identity, and can be reissued anytime. For MiniMax users, that’s exactly what Hermes Agent now offers.

What’s New?

Hermes Agent has added OAuth support for MiniMax, meaning you can now sign in with your MiniMax account instead of juggling an API key. This is especially handy if you’re a heavy MiniMax user who wants a more secure, session-based connection. The best part? It works with both the global endpoint and the China endpoint.

Why Use OAuth Over an API Key?

• No key management – No more copying, pasting, or worrying about key leaks in .env files.
• Automatic refresh – OAuth tokens expire and renew automatically, so you don’t have to manually rotate keys.
• Same tools, same power – You still get access to all MiniMax models like MiniMax-M2.7 with the same quality.

How to Set It Up

First, make sure you have Hermes Agent installed and updated. Then, add your MiniMax OAuth credentials:

hermes auth add minimax-oauth

This will open a browser window where you log in to your MiniMax account and grant access. Once done, you’re ready to chat.

Using MiniMax with OAuth

Now, instead of setting MINIMAX_API_KEY in ~/.hermes/.env, you can simply run:

hermes chat --provider minimax --model MiniMax-M2.7

For users in China, use the dedicated endpoint:

hermes chat --provider minimax-cn --model MiniMax-M2.7

Hermes automatically detects that you’re using OAuth and skips the API key check.

What About the China Endpoint?

If you’re on the China endpoint, the OAuth flow is the same. Just make sure you select MiniMax (China) when adding auth:

hermes auth add minimax-cn-oauth

Then use --provider minimax-cn as usual.

A Few Things to Keep in Mind

• OAuth tokens are stored securely in your Hermes config, not in plain text .env files.
• If your token expires, Hermes will prompt you to re-authenticate—no panic needed.
• You can still use API keys if you prefer; OAuth is just an additional option.

Summary

MiniMax OAuth integration in Hermes Agent is like upgrading from a physical key to a smart lock. It’s safer, more convenient, and removes the hassle of key management. Whether you’re on the global or China endpoint, you can now chat with MiniMax models in seconds.

Practical tip: If you’re testing multiple MiniMax models, set your provider permanently in config.yaml:

model:
  provider: "minimax"
  default: "MiniMax-M2.7"

Then you can just run hermes chat without any flags. Happy building!