Skip to main content
To use Hermes Agent with abliteration.ai, configure Hermes as a custom OpenAI-compatible endpoint with base URL https://api.abliteration.ai/v1, your ak_... API key, and model abliterated-model. Hermes already supports custom OpenAI-compatible providers, so you do not need a native adapter for abliteration.ai.

​
Install

Follow the Hermes Agent installation guide, then configure the model provider: 
hermes model
When prompted, choose the custom endpoint option and enter:
PromptValue
API base URLhttps://api.abliteration.ai/v1
API keyak_YOUR_API_KEY
Model nameabliterated-model
Context length150000

​
Manual config

You can also edit ~/.hermes/config.yaml directly: 
model:
  provider: custom
  default: abliterated-model
  base_url: https://api.abliteration.ai/v1
  api_key: ak_YOUR_API_KEY
  context_length: 150000
Then start Hermes: 
hermes chat

​
Named custom provider

If you prefer not to store the key in config.yaml, use a named custom provider with key_env and put the key in ~/.hermes/.env: 
echo 'ABLITERATION_API_KEY=ak_YOUR_API_KEY' >> ~/.hermes/.env

custom_providers:
  - name: abliteration
    base_url: https://api.abliteration.ai/v1
    key_env: ABLITERATION_API_KEY
    api_mode: chat_completions
    models:
      abliterated-model:
        context_length: 150000

model:
  provider: custom:abliteration
  default: abliterated-model
You can switch back to this provider inside a Hermes session with /model custom:abliteration:abliterated-model.

​
Provider plugin

For a named provider that works with --provider abliteration-ai, add a small Hermes model-provider plugin. Create ~/.hermes/plugins/model-providers/abliteration-ai/__init__.py: 
from providers import register_provider
from providers.base import ProviderProfile

register_provider(ProviderProfile(
    name="abliteration-ai",
    aliases=("abliteration", "ablit"),
    display_name="abliteration.ai",
    description="abliteration.ai - OpenAI-compatible unrestricted model API",
    signup_url="https://abliteration.ai/signup",
    env_vars=("ABLIT_KEY", "ABLITERATION_API_KEY", "ABLITERATION_BASE_URL"),
    base_url="https://api.abliteration.ai/v1",
    auth_type="api_key",
    default_aux_model="abliterated-model",
    fallback_models=("abliterated-model",),
))
Create ~/.hermes/plugins/model-providers/abliteration-ai/plugin.yaml: 
name: abliteration-ai
kind: model-provider
version: 1.0.0
description: abliteration.ai - OpenAI-compatible direct API
author: abliteration.ai
Export your key: 
export ABLIT_KEY="ak_YOUR_API_KEY"
Then run: 
hermes chat --provider abliteration-ai --model abliterated-model

​
Verify

hermes doctor
hermes -z "Say hello in one sentence." --provider custom -m abliterated-model
If you installed the provider plugin, use: 
hermes -z "Say hello in one sentence." --provider abliteration-ai -m abliterated-model

​
Notes

  • abliterated-model supports a 150K context window. Set context_length: 150000 so Hermes can budget long agent sessions correctly.
  • Policy rules attached to your API key apply to every Hermes request. See Policy Gateway.
  • The live model list is available from GET /v1/models. See models.
Last modified on June 12, 2026