Skip to content

Add GMI Cloud as a first-class API-key provider#11955

Closed
isaachuangGMICLOUD wants to merge 5 commits into
NousResearch:mainfrom
isaachuangGMICLOUD:feat/gmi-first-class-provider
Closed

Add GMI Cloud as a first-class API-key provider#11955
isaachuangGMICLOUD wants to merge 5 commits into
NousResearch:mainfrom
isaachuangGMICLOUD:feat/gmi-first-class-provider

Conversation

@isaachuangGMICLOUD

@isaachuangGMICLOUD isaachuangGMICLOUD commented Apr 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add GMI Cloud as a first-class API-key provider with built-in auth, aliases, provider overlays, model catalog wiring, and CLI entry points
  • wire GMI into doctor/config/env-var/docs flows and add focused regression coverage for provider resolution, model metadata, CLI flow, and auxiliary routing
  • preserve GMI context-length resolution from its live /v1/models metadata and fix cached auxiliary client handling for slash-form model overrides

Test plan

  • python -m pytest tests/hermes_cli/test_gmi_provider.py tests/hermes_cli/test_api_key_providers.py tests/agent/test_auxiliary_client.py -n0 -q
  • verified rebase conflict resolution by rerunning focused GMI/auxiliary tests
  • manual config/docs review for:
    • hermes chat --provider gmi
    • GMI_API_KEY / GMI_BASE_URL
    • GMI provider docs and fallback docs

Notes

  • full python -m pytest tests/ -q was attempted locally, but the repository's broader suite did not pass cleanly in this environment and included unrelated permission failures writing under ~/.hermes/logs/agent.log
  • GMI examples intentionally use exact model IDs returned by GMI's /v1/models endpoint

@isaachuangGMICLOUD

isaachuangGMICLOUD commented Apr 18, 2026

Copy link
Copy Markdown
Contributor Author

Rebased onto latest main and resolved conflicts. Focused GMI-related tests pass locally. GitHub Actions from fork are awaiting maintainer approval.

@isaachuangGMICLOUD

isaachuangGMICLOUD commented Apr 22, 2026

Copy link
Copy Markdown
Contributor Author

Resolved the conflicts and aligned the tests/docs with the current implementation. Also preserved the new provider entries in the docs.

@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have comp/cli CLI entry point, hermes_cli/, setup wizard comp/agent Core agent loop, run_agent.py, prompt builder labels Apr 22, 2026
@alt-glitch

alt-glitch commented Apr 22, 2026

Copy link
Copy Markdown
Collaborator

Supersedes #7397 (docs-only GMI listing) — this PR adds full first-class provider integration.

@isaachuangGMICLOUD

isaachuangGMICLOUD commented Apr 22, 2026

Copy link
Copy Markdown
Contributor Author

That matches the current scope. My original assumption was that GMI only needed the lower-level custom endpoint / docs treatment, and #7397 did not land. This PR replaces that approach with full first-class provider integration, so it supersedes the earlier docs-only listing.

@kshitijk4poor kshitijk4poor mentioned this pull request Apr 27, 2026
Merged
@kshitijk4poor

kshitijk4poor commented Apr 27, 2026

Copy link
Copy Markdown
Collaborator

Merged via PR #16663. Your commits were cherry-picked onto current main with your authorship preserved in git log. The salvage also addressed a few small review findings:

  • Removed a dead ENV_VARS_BY_VERSION[17] entry (current _config_version is 22, so existing users would never be prompted — matches how arcee was added)
  • Swapped the GMI aux model from anthropic/claude-opus-4.6 to google/gemini-3.1-flash-lite-preview (consistent with the cheap-flash pattern all other providers use)
  • Fixed a malformed write_text() call in the doctor test
  • Added gmi to the inline fallback-providers list and the --provider choices in cli-commands.md

Thanks for the contribution! 🙏

kshitijk4poor pushed a commit that referenced this pull request Apr 27, 2026
@kshitijk4poor
feat(providers): add GMI Cloud as a first-class API-key provider (#11955
c53fcb0 
)

Add GMI Cloud (api.gmi-serving.com) as a full first-class API-key provider
with built-in auth, aliases, model catalog, CLI entry points, auxiliary client
routing, context length resolution, doctor checks, env var tracking, and docs.

- auth.py: ProviderConfig for 'gmi' (api_key, GMI_API_KEY / GMI_BASE_URL)
- providers.py: HermesOverlay with extra_env_vars for models.dev detection
- models.py: curated slash-form model catalog; live /v1/models fetch
- main.py: 'gmi' in _named_custom_provider_map and --provider choices
- model_metadata.py: _URL_TO_PROVIDER, _PROVIDER_PREFIXES, dedicated
  context-length probe block (GMI's /models has authoritative data)
- auxiliary_client.py: alias entries; _compat_model fix for slash-form
  models on cached aggregator-style clients; gmi aux default model
- doctor.py: GMI in provider connectivity checks
- config.py: GMI_API_KEY / GMI_BASE_URL in OPTIONAL_ENV_VARS
- conftest.py: explicit GMI_BASE_URL clearing (not caught by _API_KEY suffix)
- docs: providers.md, environment-variables.md, fallback-providers.md,
  configuration.md, quickstart.md (expands provider table)

Co-authored-by: Isaac Huang <isaachuang@Isaacs-MacBook-Pro.local>
ulasbilgen pushed a commit to ulasbilgen/hermes-adhd-agent that referenced this pull request May 1, 2026
@kshitijk4poor
feat(providers): add GMI Cloud as a first-class API-key provider (Nou…
7df844a 
…sResearch#11955)

Add GMI Cloud (api.gmi-serving.com) as a full first-class API-key provider
with built-in auth, aliases, model catalog, CLI entry points, auxiliary client
routing, context length resolution, doctor checks, env var tracking, and docs.

- auth.py: ProviderConfig for 'gmi' (api_key, GMI_API_KEY / GMI_BASE_URL)
- providers.py: HermesOverlay with extra_env_vars for models.dev detection
- models.py: curated slash-form model catalog; live /v1/models fetch
- main.py: 'gmi' in _named_custom_provider_map and --provider choices
- model_metadata.py: _URL_TO_PROVIDER, _PROVIDER_PREFIXES, dedicated
  context-length probe block (GMI's /models has authoritative data)
- auxiliary_client.py: alias entries; _compat_model fix for slash-form
  models on cached aggregator-style clients; gmi aux default model
- doctor.py: GMI in provider connectivity checks
- config.py: GMI_API_KEY / GMI_BASE_URL in OPTIONAL_ENV_VARS
- conftest.py: explicit GMI_BASE_URL clearing (not caught by _API_KEY suffix)
- docs: providers.md, environment-variables.md, fallback-providers.md,
  configuration.md, quickstart.md (expands provider table)

Co-authored-by: Isaac Huang <isaachuang@Isaacs-MacBook-Pro.local>
donald131 pushed a commit to donald131/hermes-agent that referenced this pull request May 2, 2026
feat(providers): add GMI Cloud as a first-class API-key provider (Nou…
62fd769 
…sResearch#11955)

Add GMI Cloud (api.gmi-serving.com) as a full first-class API-key provider
with built-in auth, aliases, model catalog, CLI entry points, auxiliary client
routing, context length resolution, doctor checks, env var tracking, and docs.

- auth.py: ProviderConfig for 'gmi' (api_key, GMI_API_KEY / GMI_BASE_URL)
- providers.py: HermesOverlay with extra_env_vars for models.dev detection
- models.py: curated slash-form model catalog; live /v1/models fetch
- main.py: 'gmi' in _named_custom_provider_map and --provider choices
- model_metadata.py: _URL_TO_PROVIDER, _PROVIDER_PREFIXES, dedicated
  context-length probe block (GMI's /models has authoritative data)
- auxiliary_client.py: alias entries; _compat_model fix for slash-form
  models on cached aggregator-style clients; gmi aux default model
- doctor.py: GMI in provider connectivity checks
- config.py: GMI_API_KEY / GMI_BASE_URL in OPTIONAL_ENV_VARS
- conftest.py: explicit GMI_BASE_URL clearing (not caught by _API_KEY suffix)
- docs: providers.md, environment-variables.md, fallback-providers.md,
  configuration.md, quickstart.md (expands provider table)

Co-authored-by: Isaac Huang <isaachuang@Isaacs-MacBook-Pro.local>
@subinium subinium mentioned this pull request May 11, 2026
Open
4 tasks
02356abc pushed a commit to 02356abc/hermes-agent that referenced this pull request May 14, 2026
@kshitijk4poor
feat(providers): add GMI Cloud as a first-class API-key provider (Nou…
6302940 
…sResearch#11955)

Add GMI Cloud (api.gmi-serving.com) as a full first-class API-key provider
with built-in auth, aliases, model catalog, CLI entry points, auxiliary client
routing, context length resolution, doctor checks, env var tracking, and docs.

- auth.py: ProviderConfig for 'gmi' (api_key, GMI_API_KEY / GMI_BASE_URL)
- providers.py: HermesOverlay with extra_env_vars for models.dev detection
- models.py: curated slash-form model catalog; live /v1/models fetch
- main.py: 'gmi' in _named_custom_provider_map and --provider choices
- model_metadata.py: _URL_TO_PROVIDER, _PROVIDER_PREFIXES, dedicated
  context-length probe block (GMI's /models has authoritative data)
- auxiliary_client.py: alias entries; _compat_model fix for slash-form
  models on cached aggregator-style clients; gmi aux default model
- doctor.py: GMI in provider connectivity checks
- config.py: GMI_API_KEY / GMI_BASE_URL in OPTIONAL_ENV_VARS
- conftest.py: explicit GMI_BASE_URL clearing (not caught by _API_KEY suffix)
- docs: providers.md, environment-variables.md, fallback-providers.md,
  configuration.md, quickstart.md (expands provider table)

Co-authored-by: Isaac Huang <isaachuang@Isaacs-MacBook-Pro.local>
dannyJ848 pushed a commit to dannyJ848/hermes-agent that referenced this pull request May 17, 2026
@kshitijk4poor
feat(providers): add GMI Cloud as a first-class API-key provider (Nou…
e3babb8 
…sResearch#11955)

Add GMI Cloud (api.gmi-serving.com) as a full first-class API-key provider
with built-in auth, aliases, model catalog, CLI entry points, auxiliary client
routing, context length resolution, doctor checks, env var tracking, and docs.

- auth.py: ProviderConfig for 'gmi' (api_key, GMI_API_KEY / GMI_BASE_URL)
- providers.py: HermesOverlay with extra_env_vars for models.dev detection
- models.py: curated slash-form model catalog; live /v1/models fetch
- main.py: 'gmi' in _named_custom_provider_map and --provider choices
- model_metadata.py: _URL_TO_PROVIDER, _PROVIDER_PREFIXES, dedicated
  context-length probe block (GMI's /models has authoritative data)
- auxiliary_client.py: alias entries; _compat_model fix for slash-form
  models on cached aggregator-style clients; gmi aux default model
- doctor.py: GMI in provider connectivity checks
- config.py: GMI_API_KEY / GMI_BASE_URL in OPTIONAL_ENV_VARS
- conftest.py: explicit GMI_BASE_URL clearing (not caught by _API_KEY suffix)
- docs: providers.md, environment-variables.md, fallback-providers.md,
  configuration.md, quickstart.md (expands provider table)

Co-authored-by: Isaac Huang <isaachuang@Isaacs-MacBook-Pro.local>
gweeteve pushed a commit to gweeteve/hermes-agent that referenced this pull request Jun 2, 2026
@kshitijk4poor
feat(providers): add GMI Cloud as a first-class API-key provider (Nou…
40eecb4 
…sResearch#11955)

Add GMI Cloud (api.gmi-serving.com) as a full first-class API-key provider
with built-in auth, aliases, model catalog, CLI entry points, auxiliary client
routing, context length resolution, doctor checks, env var tracking, and docs.

- auth.py: ProviderConfig for 'gmi' (api_key, GMI_API_KEY / GMI_BASE_URL)
- providers.py: HermesOverlay with extra_env_vars for models.dev detection
- models.py: curated slash-form model catalog; live /v1/models fetch
- main.py: 'gmi' in _named_custom_provider_map and --provider choices
- model_metadata.py: _URL_TO_PROVIDER, _PROVIDER_PREFIXES, dedicated
  context-length probe block (GMI's /models has authoritative data)
- auxiliary_client.py: alias entries; _compat_model fix for slash-form
  models on cached aggregator-style clients; gmi aux default model
- doctor.py: GMI in provider connectivity checks
- config.py: GMI_API_KEY / GMI_BASE_URL in OPTIONAL_ENV_VARS
- conftest.py: explicit GMI_BASE_URL clearing (not caught by _API_KEY suffix)
- docs: providers.md, environment-variables.md, fallback-providers.md,
  configuration.md, quickstart.md (expands provider table)

Co-authored-by: Isaac Huang <isaachuang@Isaacs-MacBook-Pro.local>
Egavasyug pushed a commit to Egavasyug/hermes-agent that referenced this pull request Jun 10, 2026
@kshitijk4poor
feat(providers): add GMI Cloud as a first-class API-key provider (Nou…
8ee0ee0 
…sResearch#11955)

Add GMI Cloud (api.gmi-serving.com) as a full first-class API-key provider
with built-in auth, aliases, model catalog, CLI entry points, auxiliary client
routing, context length resolution, doctor checks, env var tracking, and docs.

- auth.py: ProviderConfig for 'gmi' (api_key, GMI_API_KEY / GMI_BASE_URL)
- providers.py: HermesOverlay with extra_env_vars for models.dev detection
- models.py: curated slash-form model catalog; live /v1/models fetch
- main.py: 'gmi' in _named_custom_provider_map and --provider choices
- model_metadata.py: _URL_TO_PROVIDER, _PROVIDER_PREFIXES, dedicated
  context-length probe block (GMI's /models has authoritative data)
- auxiliary_client.py: alias entries; _compat_model fix for slash-form
  models on cached aggregator-style clients; gmi aux default model
- doctor.py: GMI in provider connectivity checks
- config.py: GMI_API_KEY / GMI_BASE_URL in OPTIONAL_ENV_VARS
- conftest.py: explicit GMI_BASE_URL clearing (not caught by _API_KEY suffix)
- docs: providers.md, environment-variables.md, fallback-providers.md,
  configuration.md, quickstart.md (expands provider table)

Co-authored-by: Isaac Huang <isaachuang@Isaacs-MacBook-Pro.local>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

comp/agent Core agent loop, run_agent.py, prompt builder comp/cli CLI entry point, hermes_cli/, setup wizard P3 Low — cosmetic, nice to have type/feature New feature or request

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@isaachuangGMICLOUD @alt-glitch @kshitijk4poor