Connect with Hermes Agent

​

Before you begin

• A Modular Cloud account.
• A Modular Cloud API key.
• Hermes Agent installed.

​

Hermes CLI or TUI

1. Start Hermes with the command:
   hermes model
   
   The model option automatically runs the first time you run Hermes. Use the same steps to complete that initial process.
2. Select Custom endpoint.
3. Paste the base URL. Use https://api.modular.com/v1 for testing.
4. Paste your API key now, or skip if you want to configure it later.
5. Select the Auto-detect API mode.
6. Choose a model to become your default model. Hermes automatically integrates all available Modular Cloud models for you to switch to later.
7. Click Enter to auto-detect the context length.
8. Enter a display name for the provider, such as Modular Cloud.

​

Hermes Desktop

1. Open the Hermes Desktop app.
2. Click the gear icon to open Settings.
3. Open Providers > Custom Endpoints from the left navigation bar.
4. In the Add Endpoint form, fill out the following:
   • Name: Modular
   • Provider ID: modular
   • Endpoint URL: The base URL, such as https://api.modular.com/v1
   • Default Model: A Modular Cloud model you have access to. Example: minimax/minimax-m3
   • API Key: Your Modular Cloud API key
5. Click Test to test the connection, then Save.

​

Update the config file

1. Open the ~/.hermes/config.yaml config file.
2. Update the Modular Cloud custom provider section:
   model:
     provider: "custom"
     model: "minimax/minimax-m3"
     base_url: "https://api.modular.com/v1"
   

hermes config set api_key "your_api_key"