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 by Nous Research. Connect it to Qwen Cloud using pay-as-you-go, Coding Plan, or Token Plan (Team Edition).

Install Hermes Agent

  1. Run the following command in the terminal to install Hermes Agent. The installation script automatically installs dependencies such as 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. Run the following command to verify the installation. A version number in the output indicates a successful installation.
hermes --version

Configure access credentials

Use the hermes config set command to configure access parameters. Enter the Base URL and API Key corresponding to 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 the Token Plan (Team Edition) dedicated API Key. For available models, refer to Token Plan (Team Edition) supported models. 
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.6-plus

Coding Plan

Replace YOUR_API_KEY with the Coding Plan dedicated API Key. For available models, refer to Coding Plan supported models. 
hermes config set model.provider custom
hermes config set model.base_url https://coding-intl.dashscope.aliyuncs.com/compatible-mode/v1
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.6-plus

Pay-as-you-go

Replace YOUR_API_KEY with your Qwen Cloud API Key. For available models, refer to OpenAI compatible - Supported models. 
hermes config set model.provider custom
hermes config set model.base_url https://dashscope-intl.aliyuncs.com/compatible-mode/v1
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.6-plus

Verify configuration

After completing the configuration, run the following command to send a test message: 
hermes chat -q "Hello"
If a normal response is returned, the configuration is successful. To switch models, specify the model using the -m parameter: 
hermes chat -m qwen3.6-plus

FAQ

Error codes

If you encounter errors during configuration, refer to the FAQ documentation for the corresponding billing plan:

Still connecting to OpenRouter after configuration

Hermes Agent uses OpenRouter as the default inference provider. When connecting to Qwen Cloud, model.provider must be set to custom. Run the following command to verify: 
hermes config set model.provider custom