Prerequisites
- An Inception API key
- macOS, Linux, Windows, or WSL2
Setup
1
Install Hermes Agent
Follow the Hermes installation guide, or install it on macOS, Linux, or WSL2:Open a new terminal after installation so the
hermes command is available.2
Add Inception as a custom endpoint
Open Hermes’s model picker:Select Custom endpoint (enter URL manually) and enter:
If Mercury 2.5 does not appear during model discovery, enter
mercury-2.5 manually. Hermes stores the key in its user-only .env file and saves Mercury 2.5 as the default model.3
Start Hermes
Launch an interactive session:The startup message should show
mercury-2.5 with the custom provider.Verify the integration
Run a one-shot prompt:Mercury 2.5 is connected.
Troubleshooting
Troubleshooting
- Hermes cannot find the endpoint: Confirm the base URL ends in
/v1and the compatibility mode is Chat Completions. - Mercury 2.5 is not listed: Enter
mercury-2.5manually in the custom endpoint flow. - The wrong model is active: Run
hermes modelagain and select the saved Inception provider.