Hermes Agent - Terminal AI Coding Tool | Model Studio - Alibaba Cloud Model Studio

Install Hermes Agent

Run this command to install Hermes Agent. The script automatically installs dependencies like Python and Git.
```
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
Note
Windows does not support native installation. Install WSL2 first, then run the above command in WSL2.

After installation, reload the terminal environment.

source ~/.bashrc    # If using zsh, change to source ~/.zshrc

Verify the installation. A version number confirms success.
```
hermes --version
```

Configure Access Credentials

Run hermes config set to configure the Base URL and API Key for your chosen plan:

Token Plan (Team Edition): Seat-based subscription; token consumption deducts Credits.
Coding Plan: Fixed monthly subscription, metered by model invocation count.
Pay-as-you-go: Post-paid based on actual usage.

Token Plan (Team Edition)

Replace YOUR_API_KEY with your Token Plan (Team Edition) API Key. Available models are listed in supported models.

hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-max

These commands write to ~/.hermes/config.yaml. You can also edit the file directly:

config.yaml example

model:
  default: qwen3.7-max
  provider: custom
  base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Coding Plan

Replace YOUR_API_KEY with your Coding Plan API Key. Available models are listed in supported models.

hermes config set model.provider custom
hermes config set model.base_url https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-plus

These commands write to ~/.hermes/config.yaml. You can also edit the file directly:

config.yaml example

model:
  default: qwen3.7-plus
  provider: custom
  base_url: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Pay-as-you-go

Replace YOUR_API_KEY with your Alibaba Cloud Model Studio API Key. Available models are listed in Anthropic compatible API. Set base_url for your region. The API Key must match the selected region:

China North 2 (Beijing): https://dashscope.aliyuncs.com/apps/anthropic
Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. Replace WorkspaceId with your actual Get the Workspace ID

hermes config set model.provider custom
hermes config set model.base_url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-max

These commands write to ~/.hermes/config.yaml. You can also edit the file directly:

config.yaml example

model:
  default: qwen3.7-max
  provider: custom
  base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Verify Configuration

Send a test message to verify your configuration:

hermes chat -q "Hello"

A successful response confirms the configuration works. To switch models, use the -m parameter:

hermes chat -m qwen3.7-max

FAQ

Error Codes

For configuration errors, check the FAQ for your billing plan:

Pay-as-you-go: Error Code Troubleshooting
Coding Plan: Coding Plan FAQ
Token Plan (Team Edition): Token Plan (Team Edition) FAQ

Still connecting to OpenRouter after configuration

Hermes Agent defaults to OpenRouter. To use Model Studio, set model.provider to custom:

hermes config set model.provider custom