Sogni: Learn logo

πŸͺ½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-iq4xs
  • qwen3.5-35b-a3b-abliterated-gguf-q4km

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.

Last updated 2026-04-20