Before you start: create a Fortytwo API key and buy credits — see Quickstart, step 1. Give each agent its own key with a Spend limit.
Install the Fortytwo plugin
The Fortytwo plugin from the Hermes plugin catalogue adds Fortytwo to the Hermes provider list, next to the built-in providers. It needs Hermes 0.22.5 or later.- Desktop app
- Terminal
1
Install Hermes
Download the installer from hermes-agent.nousresearch.com/desktop . Install it, open Hermes and finish onboarding. If Hermes asks for a provider, choose I’ll choose a provider later.
2
Install the plugin
- Open the Fortytwo plugin page in the Hermes catalogue.
- Press Install in Hermes. Hermes opens an install dialog.
- Press Install. The dialog also turns the plugin on.


3
Enter your API key
Open Settings (Cmd+, on macOS, Ctrl+, on Windows) → Providers → API keys. Open Fortytwo, paste your Fortytwo API key and press Save.

4
Start a chat
Press Cmd+N (Ctrl+N on Windows). In the model picker next to the message box, choose Qwen3.8 27B, or another model under Fortytwo. In the effort picker, keep Medium, or choose Extra High, the recommended level, which uses more tokens. Then send a message.



none, low, medium and xhigh. Other Hermes levels round down to the nearest of them. To remove the plugin, run hermes plugins remove fortytwo-provider.
Or connect through a custom endpoint
Use this if you cannot install plugins or run a Hermes version older than 0.22.5. You enter the Fortytwo endpoint by hand.- Desktop app: custom endpoint
- Terminal: custom endpoint
1
Install Hermes
Download the installer from hermes-agent.nousresearch.com/desktop . Install it.On Linux, install Hermes in the terminal (see the Terminal: custom endpoint tab).
2
Hermes onboarding: skip the provider choice
Open Hermes. On the first screen, Let’s get you setup with Hermes Agent, choose I’ll choose a provider later.
3
Add Fortytwo as a custom endpoint
- Open Settings (Cmd+, on macOS, Ctrl+, on Windows).
- Open Providers → Custom Endpoints.
- Fill in the endpoint form:
Keep Use for new chats on.Another model works the same way: take its ID, context window and max output from Models.
-
Press Test. Hermes shows Endpoint is reachable. Found N models. Test before you save: after Save, Test reports that the endpoint rejected the API key, though the saved endpoint works.

-
Press Save. Hermes shows Custom endpoint saved and lists Fortytwo under Custom Endpoints as Active.

4
Start a chat
Press Cmd+N (Ctrl+N on Windows). In the model picker next to the message box, check that Qwen3.8 27b is selected under Fortytwo, then send a message. The same picker turns Thinking on or off.



Something not working with your agent, or using one we have not listed? Tell us in the platform: Feedback for ideas and small bugs, Contact support if it blocks your work, or Report a security issue.




