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):
- 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).
- 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
- Configure
config.yaml to use provider: vertex with google/gemini-2.5-flash.
- Open Hermes Desktop App (Electron) or Hermes Studio Web UI (
127.0.0.1:8748).
- Notice that the sidebar dropdown forces the provider back to OpenRouter or other preset choices, and
vertex is completely missing from the sidebar dropdown.
- Try to find a way to specify the Google Service Account JSON path in the UI — there is no such input field.
Proposed Solution
- 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).
- 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.
Summary
Currently, Hermes Agent v0.18.0 (v2026.7.1) natively supports the GCP
vertexprovider 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):
vertexas a selectable provider (even if it's correctly configured as the default provider inconfig.yaml).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
config.yamlto useprovider: vertexwithgoogle/gemini-2.5-flash.127.0.0.1:8748).vertexis completely missing from the sidebar dropdown.Proposed Solution
"vertex"to the hardcoded preset providers list in the GUI React components (or dynamically read enabled providers from the backend's active profile/config).vertex, add a file picker (or text input for absolute path) to mapvertex.credentials_path(storing the path inconfig.yamlor writing it to.envasVERTEX_CREDENTIALS_PATH).Expected Behavior
Users should be able to fully select Vertex AI (
vertexprovider) 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.