hermes - 💡(How to fix) Fix hermes doctor: duplicate `anthropic` check fails with HTTP 404 (wrong auth header in pluggable provider check) [4 pull requests]

Official PRs (…)
ON THIS PAGE

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…

hermes doctor in v2026.5.7 reports a duplicate Anthropic API check. The dedicated Anthropic API check passes; the new lowercase pluggable-provider anthropic check fails with HTTP 404 because it uses generic Authorization: Bearer auth instead of Anthropic's required x-api-key header.

Root Cause

hermes_cli/doctor.py:

  • Line 1203–1244: dedicated Anthropic check uses correct headers — headers["x-api-key"] = anthropic_key + anthropic-version: 2023-06-01
  • Line 1265–1325: generic _apikey_providers loop uses Authorization: Bearer {key} for all providers
  • The pluggable ProviderProfile for Anthropic (loaded via from providers import list_providers) extends _apikey_providers, but the generic loop doesn't know Anthropic needs special headers

Fix Action

Fixed

Code Example

Checking Anthropic API...Anthropic API
Checking anthropic API...anthropic            (HTTP 404)
RAW_BUFFERClick to expand / collapse

Summary

hermes doctor in v2026.5.7 reports a duplicate Anthropic API check. The dedicated Anthropic API check passes; the new lowercase pluggable-provider anthropic check fails with HTTP 404 because it uses generic Authorization: Bearer auth instead of Anthropic's required x-api-key header.

Reproduction

  1. Set ANTHROPIC_API_KEY in ~/.hermes/.env (valid key)
  2. Configure model to route via OpenRouter (e.g. model.default: anthropic/claude-haiku-4.5, model.provider: openrouter)
  3. Run hermes doctor
  4. Observe duplicate Anthropic-related lines in the API Connectivity section:
Checking Anthropic API...  ✓ Anthropic API
Checking anthropic API...  ⚠ anthropic            (HTTP 404)

Expected behaviour

Either:

  • The lowercase anthropic provider check uses the correct Anthropic native auth (x-api-key + anthropic-version headers), or
  • The provider system suppresses the duplicate check when a dedicated check already covers the same provider

Actual behaviour

Lowercase anthropic check uses Authorization: Bearer {key} (the generic pluggable-provider auth at hermes_cli/doctor.py line ~1295) and Anthropic's native API returns HTTP 404.

Root cause analysis

hermes_cli/doctor.py:

  • Line 1203–1244: dedicated Anthropic check uses correct headers — headers["x-api-key"] = anthropic_key + anthropic-version: 2023-06-01
  • Line 1265–1325: generic _apikey_providers loop uses Authorization: Bearer {key} for all providers
  • The pluggable ProviderProfile for Anthropic (loaded via from providers import list_providers) extends _apikey_providers, but the generic loop doesn't know Anthropic needs special headers

Suggested fix

In _build_apikey_providers_list() or the provider loop:

  • Skip provider profiles whose canonical name matches a provider that already has a dedicated check (anthropic in this case), or
  • Have ProviderProfile declare a custom health_check_headers field that overrides the generic Bearer auth

Environment

  • Hermes Agent v0.13.0 (calver v2026.5.7-136-g524cbabd8)
  • macOS 26.4.1, Apple Silicon
  • Python 3.11.15
  • Routing via OpenRouter (no direct Anthropic native API usage)

Impact

Cosmetic only. Hermes functions correctly; this is a noisy warning from a duplicate check, not a real connectivity failure.

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

hermes - 💡(How to fix) Fix hermes doctor: duplicate `anthropic` check fails with HTTP 404 (wrong auth header in pluggable provider check) [4 pull requests]