Skip to main content
After connecting the Gravitex gateway in the Hermes Agent Desktop App, you can directly call the model services provided by Gravitex within Hermes.
Download: https://hermes-agent.nousresearch.com/
Prerequisites: Hermes Agent Desktop App is installed and a Gravitex API Key has been obtained.

โ€‹
1. Configuration Steps

โ€‹
Step 1: Open Custom Endpoints

Go to Providers โ†’ Custom Endpoints in the left menu, then click New endpoint at the bottom to create one. Open Custom Endpoints

โ€‹
Step 2: Fill in Gravitex Gateway Information

In the Edit Endpoint form, fill in the following: Check Use for new chats and Discover models, click Test to confirm connectivity, then click Save to save. Fill in Gravitex Gateway Information

โ€‹
Step 3: Confirm Gateway Connection Mode

Go to Gateways in the left menu and check Connection mode. The default is Local gateway (runs locally, supports offline). You generally do not need to change this for Gravitex integration; only switch to Hermes Cloud / Remote gateway / Connect via SSH when you need the Hermes backend to run remotely or in the cloud. Confirm Gateway Connection Mode

โ€‹
Step 4: Select gravitex in Model

Go to Model in the left menu, select gravitex (configured in Step 2) from the model dropdown, and click Apply. To assign separate models for auxiliary tasks such as Vision, Web extract, Compression, Skills hub, Approval, MCP, Title gen, etc., click Change next to each item under Auxiliary models; by default they all follow the main model (auto ยท use main model). Select gravitex in Model

โ€‹
Step 5: Send a Test Message

Go back to the Chat page and send a message to confirm you can receive a normal response from the gravitex gateway.

โ€‹
2. Verify Success

  • gravitex is visible and can be successfully selected in the Model selector, with no errors after clicking Apply.
  • Messages sent in Chat receive normal replies without invalid api key / endpoint unavailable / model_not_found errors.

โ€‹
3. Troubleshooting

โ€‹
4. Security Notes

  • API Key is equivalent to a password โ€” do not include it in public documentation, chat records, screenshots, or code repositories.
  • Custom Endpoint details may display key information in the form of environment variables (e.g., ${HERMES_CUSTOM_GRAVITEX_API_KEY}). Do not share screenshots in public environments.
  • If your key has been leaked in chats, logs, or screenshots, immediately revoke and regenerate it in the Gravitex console.