Skip to content

feat: add HERMES_LLM_BASE_URL fallback for MeshBoard stream-tap proxy#23

Merged
OmarB97 merged 1 commit into
mainfrom
fix/hermes-llm-base-url-env
May 29, 2026
Merged

feat: add HERMES_LLM_BASE_URL fallback for MeshBoard stream-tap proxy#23
OmarB97 merged 1 commit into
mainfrom
fix/hermes-llm-base-url-env

Conversation

@OmarB97

@OmarB97 OmarB97 commented May 29, 2026

Copy link
Copy Markdown
Owner

Summary

Add HERMES_LLM_BASE_URL env var support so MeshBoard stream-tap launcher can intercept inference traffic via a local proxy.

Changes

hermes_cli/runtime_provider.py

  • Pool entries: HERMES_LLM_BASE_URL overrides pool base_url for non-OAuth providers (OAuth tokens are scoped to their own endpoints and must not be redirected)
  • _resolve_openrouter_runtime: fallback after OPENROUTER_BASE_URL and CUSTOM_BASE_URL
  • _resolve_explicit_runtime: fallback after provider-specific env vars

hermes_cli/main.py

  • HERMES_SKIP_PROFILE_OVERRIDE: skip profile resolution entirely when set, allowing stream-tap launcher to force a specific HERMES_HOME without profile redirection

Precedence

Provider-specific env vars (e.g. OPENROUTER_BASE_URL) always win over HERMES_LLM_BASE_URL. The env var is a fallback, not an override.

Tests

  • 5 new tests for HERMES_LLM_BASE_URL (pool, explicit path, precedence, trailing slash, no-env fallback)
  • 1 new test for HERMES_SKIP_PROFILE_OVERRIDE
  • All 131 existing tests pass

Fixes hermes-llm-base-url-env-override

… support

MeshBoard stream-tap launcher needs to intercept inference traffic via a
local proxy. Add HERMES_LLM_BASE_URL env var that overrides the resolved
base_url, with proper precedence rules:

- Pool entries: HERMES_LLM_BASE_URL overrides pool base_url for non-OAuth
  providers (OAuth tokens are scoped to their own endpoints)
- _resolve_openrouter_runtime: fallback after OPENROUTER_BASE_URL
- _resolve_explicit_runtime: fallback after provider-specific env vars

Also add HERMES_SKIP_PROFILE_OVERRIDE env var to skip profile resolution
when stream-tap launcher needs to force a specific HERMES_HOME.

Fixes hermes-llm-base-url-env-override
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant