Skip to content

[Desktop/Web UI] Support 'vertex' provider and Service Account JSON upload in GUI #56687

Description

@c193764582

Summary

Currently, Hermes Agent v0.18.0 (v2026.7.1) natively supports the GCP vertex provider with enterprise-grade Service Account JSON authentication and automatic OAuth2 token refreshing (which is a massive and excellent update!).

However, there is a major feature gap/bug in the Desktop GUI (Electron app) / Web UI (Hermes Studio):

  1. The sidebar's provider selection dropdown does not list vertex as a selectable provider (even if it's correctly configured as the default provider in config.yaml).
  2. There is no input field or file-uploader in the Web UI / Desktop settings page to upload or specify the path for the Service Account JSON credentials file (gcp-service-account.json).

Because of this, users who want to run the agent in the GUI or Web UI are permanently locked out of utilizing the new Vertex AI (vertex) provider and are instead forced back into using other CLI-fallback providers like OpenRouter or AI Studio, or running strictly on TUI.

Steps to Reproduce

  1. Configure config.yaml to use provider: vertex with google/gemini-2.5-flash.
  2. Open Hermes Desktop App (Electron) or Hermes Studio Web UI (127.0.0.1:8748).
  3. Notice that the sidebar dropdown forces the provider back to OpenRouter or other preset choices, and vertex is completely missing from the sidebar dropdown.
  4. Try to find a way to specify the Google Service Account JSON path in the UI — there is no such input field.

Proposed Solution

  1. Widen the GUI dropdown providers list: Explicitly append "vertex" to the hardcoded preset providers list in the GUI React components (or dynamically read enabled providers from the backend's active profile/config).
  2. Add a Credential File Uploader:
    • In the settings panel for vertex, add a file picker (or text input for absolute path) to map vertex.credentials_path (storing the path in config.yaml or writing it to .env as VERTEX_CREDENTIALS_PATH).
    • Alternatively, support the new Google Cloud static API keys for Vertex AI (which was recently released by Google as part of the "Gemini Enterprise Agent Platform" rebranding).

Expected Behavior

Users should be able to fully select Vertex AI (vertex provider) directly in the Desktop GUI sidebar and input their credentials (either JSON path or static API key) to enjoy the enterprise-grade Gemini models with zero friction.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3Low — cosmetic, nice to havearea/authAuthentication, OAuth, credential poolsarea/configConfig system, migrations, profilescomp/dashboardWeb dashboard / control panel UI (dashboard/, landing)comp/desktopElectron desktop app (apps/desktop/*)provider/geminiGoogle Gemini (AI Studio, Cloud Code)sweeper:implemented-on-mainSweeper: behavior already present on current maintype/featureNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions