Skip to main content
Qwen Cloud home page
Docs
Clients & tools

Hermes Agent

Terminal AI coding assistant by Nous Research

Hermes Agent is a terminal AI coding tool that connects to Qwen Cloud through pay-as-you-go, Coding Plan, or Token Plan (Team Edition).

Install Hermes Agent

  1. 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
Windows does not support native installation. Install WSL2 first, then run the above command in WSL2.
  1. After installation, reload the terminal environment.
source ~/.bashrc    # If using zsh, change to source ~/.zshrc
  1. 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

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

Pay-as-you-go

Replace YOUR_API_KEY with your Qwen Cloud API Key. Available models are listed in Anthropic compatible API. Set base_url for your region. The API Key must match the selected region:
  • Singapore: https://dashscope-intl.aliyuncs.com/apps/anthropic
hermes config set model.provider custom
hermes config set model.base_url https://dashscope-intl.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

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:

Still connecting to OpenRouter after configuration

Hermes Agent defaults to OpenRouter. To use Qwen Cloud, set model.provider to custom: 
hermes config set model.provider custom