Hermes Agent Integration
Hermes Agent can use Sogni Intelligence through an OpenAI-compatible custom endpoint. Use this when you want Hermes Agent to route prompts to Sogni's Qwen models while keeping Hermes' local agent workflow.
#Prerequisites
- Hermes Agent installed.
- A Sogni API key from dashboard.sogni.ai.
- A Sogni account with Spark or SOGNI token balance.
#Interactive Setup
Run Hermes' model configuration command:
hermes model
Choose the custom endpoint/manual URL option, then enter:
| Setting | Value |
|---|---|
| Base URL | https://api.sogni.ai/v1 |
| API key | Your Sogni API key |
| Model | qwen3.6-35b-a3b-gguf-iq4xs |
If Hermes asks for a provider type, choose the OpenAI-compatible option.
#Config-File Setup
Hermes also supports direct endpoint overrides in configuration. Use these values if you manage Hermes through a config file:
delegation:
base_url: "https://api.sogni.ai/v1"
api_key: "YOUR_SOGNI_API_KEY"
model: "qwen3.6-35b-a3b-gguf-iq4xs"
Use GET https://api.sogni.ai/v1/models for the current model list. Current public model IDs include:
qwen3.6-35b-a3b-gguf-iq4xsqwen3.5-35b-a3b-abliterated-gguf-q4km
#Recommended Defaults
For coding and agent work, start with:
{
"model": "qwen3.6-35b-a3b-gguf-iq4xs",
"task_profile": "coding",
"chat_template_kwargs": {
"enable_thinking": true
}
}
Hermes may not expose every provider-specific request field in its UI. If it does expose extra body fields and you want a coding-only setup, set sogni_tools: false so Sogni does not inject media tools. Leave Sogni tools enabled if you want Hermes to be able to request image, video, or music generation through Sogni.
#Verify
Ask Hermes:
Which model and API base URL are you using?
Then try a short coding prompt:
Write a TypeScript function that validates an Ethereum address and explain edge cases.
#Troubleshooting
| Issue | Fix |
|---|---|
401 authentication_error |
Confirm the Hermes custom endpoint is using your Sogni API key, not an OpenAI or OpenRouter key. |
| Model not found | Use qwen3.6-35b-a3b-gguf-iq4xs or query /v1/models for the current list. |
402 insufficient_quota |
Add Spark or SOGNI token balance in the Sogni dashboard. |
| Hermes falls back to another provider | Re-run hermes model and confirm the custom endpoint is selected. |
| Requests work in curl but not Hermes | Check whether Hermes is overriding base_url, api_key, or model from a different config profile. |
See the Hermes Agent configuration docs for the current custom endpoint settings.