TokenDock Docs Blog
/
Log in Create Account

Hermes Agent

Use TokenDock with Hermes Agent through Hermes' built-in custom OpenAI-compatible endpoint setup. No native Hermes provider is required.

Before you start

  • Create a TokenDock API key from your TokenDock account.
  • Keep the key private. Do not paste it into documentation, screenshots, or shared shell history.
  • Use the TokenDock OpenAI-compatible base URL: https://tokendock.ai/v1.

Configure Hermes

  1. Run hermes model.
  2. Choose Custom endpoint (enter URL manually) from the provider picker.
  3. At the API base URL prompt, enter https://tokendock.ai/v1.
  4. Paste your TokenDock API key when Hermes asks for the API key.
  5. Hermes will verify the endpoint with https://tokendock.ai/v1/models.
  6. Select one of the TokenDock models returned by the live model list.
  7. If Hermes asks for a display name, use TokenDock.
Keep /v1 in the base URL. If Hermes suggests trying https://tokendock.ai, keep using https://tokendock.ai/v1 for TokenDock's OpenAI-compatible API.

Recommended models

Hermes reads the live model list from TokenDock. The exact list can change as models are added or retired. Common choices include:

  • Qwen3.6-Plus-256k for a balanced default chat model.
  • Qwen3.6-Plus-1m for very long-context work.
  • MiniMax-M2.5 or MiniMax-M2.7 for MiniMax workloads.
  • deepseek-v3.2 for DeepSeek access.

Verify manually

You can verify your key and model list outside Hermes:

Shell 
export TOKENDOCK_API_KEY="your-tokendock-api-key"
curl https://tokendock.ai/v1/models \
  -H "Authorization: Bearer $TOKENDOCK_API_KEY"

Troubleshooting

  • Verification warning: Confirm Hermes is sending the API key and that the base URL is exactly https://tokendock.ai/v1.
  • 404 on models: Check that Hermes did not construct /v1/v1/models. The correct full URL is https://tokendock.ai/v1/models.
  • Model not found: Run the manual curl command above and copy the exact model ID returned by TokenDock.

Screenshot guide

If you are preparing an internal setup walkthrough, save screenshots using these filenames:

  • 01-select-custom-endpoint.png
  • 02-enter-token-dock-base-url.png
  • 03-select-token-dock-model.png