Skip to main content
Hermes Agent is an open-source terminal AI Agent by Nous Research, providing powerful tool calling, file read/write, and code execution capabilities in your terminal. With built-in Custom Endpoint support, Hermes can seamlessly connect to any OpenAI-compatible API — including Mixroute — without writing any code or plugins.

​
Core Features

Intelligent Agent

Native support for tool calling, file read/write, and code execution with persistent memory

Multi-channel Integration

Unified messaging gateway for Telegram, Discord, Slack, WhatsApp and more

Open Model Ecosystem

Built-in Custom Endpoint support for any OpenAI-compatible API

​
Prerequisites

1

Prepare Mixroute Address

Get an available Mixroute address, for example: https://api.mixroute.ai/v1
If you need to use native ports, you need to configure according to the endpoints in the API documentation. It is recommended to keep the settings in this guide to avoid errors and issues caused by different endpoints.
2

Get API Key

Generate an API Key in the Mixroute console
3

Choose a Model

Determine the model name you want to use, which must exactly match the model ID in the Mixroute console (e.g., gpt-5.5)
Hermes Agent requires the model to support at least 64K tokens context window. Please verify this requirement when selecting a model, otherwise you may encounter context insufficient errors.

​
Install Hermes Agent

  • Run the official one-click installation script in your terminal: Choose Quick setup mode to deploy and configure core settings. For Provider and Model details, see Configure mixroute integration.
  • After installation, reload your terminal environment variables:
Run hermes --version. If a version number is displayed, the installation was successful.

​
Configure Mixroute Integration

This is the most critical step in the integration process. Hermes Agent provides an interactive menu, so you don’t need to write any code or manually edit configuration files — just follow the prompts to enter the Mixroute URL, Key, and model name.
After configuration, if you want to change settings or failed to complete the provider setup during the interactive guide, you can run hermes model at any time after Hermes Agent deployment to overwrite the previous configuration and enter a new URL, Key, or model name.
1

Select Provider

Use arrow keys to scroll to Custom Endpoint (or similar “custom endpoint” option) and press Enter to confirm.
For multi-provider scenarios, it is recommended to configure multiple SKs on the platform for separate management.
2

Enter Base URL

Enter your Mixroute address, for example:
This is the most common source of configuration errors. You need to use native model capabilities. Please refer to the API documentation and model marketplace information to revise the Base URL.Mismatched endpoints may cause Hermes to malfunction or incur additional costs.
3

Enter API Key

Enter the API Key generated in your Mixroute console, for example:
4

Enter Model Name

Enter the model you want to use, for example:
The model name must exactly match the ID in the Mixroute model catalog, otherwise you will get a “model not found” error.
5

Select API Mode

Hermes has four compatible modes. Select based on your model. Hermes defaults to Auto-detect.
  1. Auto-detect [current]
    Use Hermes URL heuristics; best for standard OpenAI-compatible endpoints.
  2. Chat Completions
    Use /chat/completions for standard OpenAI-compatible servers.
  3. Responses / Codex
    Use /responses for Codex-compatible tool-calling backends.
  4. Anthropic Messages
    Use /v1/messages for Anthropic-compatible endpoints.

​
Smart Routing Integration (Optional)

Smart Routing is an intelligent model routing capability that automatically distributes requests to the most suitable model based on task complexity, reducing API costs while enhancing efficiency.Add the following configuration to complete the integration. See here for constraints and usage guide.

​
Key Configuration Reference

​
Verify Integration

After configuration, start Hermes to begin a conversation:
Or use the more modern TUI mode (terminal graphical interface):
Enter a test message, for example:
If the model responds normally, the integration is successful.

​
View and Switch Models

Enter the following command directly in the conversation to view the current model and switch quickly:

​
FAQ

Check if the Base URL ends with /v1
Confirm the model name exactly matches the model ID in the Mixroute console
Generate a new Key in the Mixroute console, then run hermes model again
Enter hermes model in the terminal and press Enter
Run hermes model again, or enter /model in the conversation
Run hermes model again, which will overwrite the previous settings
Hermes does not natively support Windows. Please install WSL2 first and execute the installation command in the WSL2 terminal
After integrating with Mixroute, all subsequent Hermes Agent capabilities (messaging gateway, skill calling, background service, etc.) will call your selected model through Mixroute, without needing to configure model providers separately for each feature.