hermes - 💡(How to fix) Fix [Bug]: DashScope provider defaults to intl endpoint unreachable from mainland China

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

  1. Connection fails with timeout / DNS error Every Hermes user in mainland China using DashScope hits this. The workaround (setting DASHSCOPE_BASE_URL) exists but is undocumented — users have to discover it themselves through trial and error or reading source code.

Fix Action

Fix / Workaround

Every Hermes user in mainland China using DashScope hits this. The workaround (setting DASHSCOPE_BASE_URL) exists but is undocumented — users have to discover it themselves through trial and error or reading source code.

Code Example

# plugins/model-providers/alibaba/__init__.py line 10
base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
RAW_BUFFERClick to expand / collapse

Problem

The Alibaba Cloud DashScope provider (alibaba / dashscope) defaults to the international endpoint:

# plugins/model-providers/alibaba/__init__.py line 10
base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",

This endpoint is not reachable from mainland China — DNS resolution fails or connections time out. Chinese users who configure DASHSCOPE_API_KEY and try to use DashScope models (qwen-turbo, qwen-plus, qwen-max, etc.) get connection errors with no clear indication that the problem is the endpoint URL.

The correct endpoint for mainland China users is https://dashscope.aliyuncs.com/compatible-mode/v1.

Steps to Reproduce

  1. On a machine in mainland China, run hermes setup and configure DashScope with a valid API key
  2. Try to chat with any DashScope model
  3. Connection fails with timeout / DNS error

Impact

Every Hermes user in mainland China using DashScope hits this. The workaround (setting DASHSCOPE_BASE_URL) exists but is undocumented — users have to discover it themselves through trial and error or reading source code.

Proposed Fix

Option A (minimal): Add a note in hermes setup and provider docs that mainland China users need DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1.

Option B (better): Auto-detect. During hermes setup, try the intl endpoint first. If it fails, try the domestic endpoint and suggest it as the default for users in China.

Option C (configurable): Ship a hermes config preset for China users that pre-sets the domestic endpoints for all affected providers (DashScope, and potentially others like Baidu, Zhipu, etc.).

Environment

Mainland China network environment. DNS for dashscope-intl.aliyuncs.com is either unresolvable or returns addresses unreachable from within China.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING