Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Bug] OpenCode Zen: Incorrect default base_url (api.opencode-zen.com instead of opencode.ai/zen/v1) [1 comments, 2 participants]

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…
GitHub stats
NousResearch/hermes-agent#11661•Fetched 2026-04-18 05:59:32
View on GitHub
Comments
1
Participants
2
Timeline
1
Reactions
0
Author
botmeistrbotmeistr
Participants
botmeistrbotmeistrhclsyshclsys
Timeline (top)
commented ×1

Root Cause

Using the incorrect URL results in connection failures (HTTP errors) because the API endpoint does not resolve.

Fix Action

Workaround

Manually edit ~/.hermes/config.yaml:

model:
  provider: opencode-zen
  base_url: https://opencode.ai/zen/v1

Code Example

model:
  provider: opencode-zen
  base_url: https://opencode.ai/zen/v1
RAW_BUFFERClick to expand / collapse

Bug Description

When setting up Hermes with the OpenCode Zen provider, the default base_url is set to https://api.opencode-zen.com/v1, which is incorrect. The correct base URL is https://opencode.ai/zen/v1.

Using the incorrect URL results in connection failures (HTTP errors) because the API endpoint does not resolve.

Steps to Reproduce

  1. Run hermes setup or hermes model and select OpenCode Zen as provider
  2. The base_url in ~/.hermes/config.yaml is set to https://api.opencode-zen.com/v1
  3. Attempt to use any model via OpenCode Zen — connection fails
  4. Manually change base_url to https://opencode.ai/zen/v1 → everything works

Expected Behavior

The default base_url for the OpenCode Zen provider should be https://opencode.ai/zen/v1, not https://api.opencode-zen.com/v1.

Workaround

Manually edit ~/.hermes/config.yaml:

model:
  provider: opencode-zen
  base_url: https://opencode.ai/zen/v1

Environment

  • Hermes Agent: latest
  • Provider: OpenCode Zen
  • Config path: ~/.hermes/config.yaml

Additional Context

Note that OpenCode Go uses the similar pattern https://opencode.ai/zen/go/v1 (as seen in issue #10469), which confirms opencode.ai is the correct domain for all OpenCode providers.

extent analysis

TL;DR

Update the base_url for the OpenCode Zen provider in the Hermes configuration to https://opencode.ai/zen/v1 to resolve connection failures.

Guidance

  • Verify the current base_url setting in ~/.hermes/config.yaml to confirm it is set to the incorrect value https://api.opencode-zen.com/v1.
  • Manually update the base_url in ~/.hermes/config.yaml to the correct value https://opencode.ai/zen/v1 as a temporary workaround.
  • Test the connection again after updating the base_url to ensure the issue is resolved.
  • Consider reporting the issue to the Hermes development team to request a permanent fix to update the default base_url for the OpenCode Zen provider.

Example

model:
  provider: opencode-zen
  base_url: https://opencode.ai/zen/v1

Notes

This workaround assumes that the issue is solely due to the incorrect base_url setting. If other issues persist after updating the base_url, further investigation may be necessary.

Recommendation

Apply the workaround by manually updating the base_url in ~/.hermes/config.yaml until a permanent fix is available, as it is a simple and effective solution to resolve the connection failures.

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…
#api#inference speed#output truncation#response parsing#generation error

Still need to ship something?

×6

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

Back to top recommendations

TRENDING