Hermes Agent ​

Support: pay-as-you-go Xiaoku APIs are supported.

Requirements ​

Linux, macOS, and WSL2 (Windows) are supported. On Windows, install WSL2 first.

Install ​

bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Reload the shell: source ~/.bashrc or source ~/.zshrc

Check: hermes --version

Built-in provider ​

On first setup choose Quick setup (or run hermes setup to reopen the wizard), select the Xiaoku provider, and set the API key, base URL, and default model.

Custom provider ​

Option 1 (CLI) ​

model.provider must be custom:

bash
hermes config set model.provider custom
hermes config set model.base_url BASE_URL
hermes config set model.api_key XIAOKU_API_KEY
hermes config set model.default mimo-v2.5-pro

Option 2 (edit the config file) ​

Edit ~/.hermes/config.yaml:

yaml
model:
  provider: custom
  base_url: https://api-ai.xiaoku.ai/v1
  api_key: XIAOKU_API_KEY
  default: deepseek-v4-pro

Then run hermes doctor.

Use ​

  • Classic CLI: hermes
  • Modern TUI: hermes --tui