Any OpenAI-compatible endpoint can be a named entry under providers in Hermes Agent’s ~/.hermes/config.yaml. Add one, and the agent reads files and runs shell commands on an uncensored model, paid per token from a prepaid balance. OpenClaw and OpenCode take the same ids.
What you need
- Hermes Agent installed.
- A key from the console. Give Hermes a key of its own, so its traffic is easy to pick out on the usage page.
- A model id from the models page; the YAML below opens with a short list of them.
Three steps to a first reply
- Make the key in the console and write it to the env file as a single line:
# ~/.hermes/.envUNRESTRICTABLE_API_KEY=sk-unr-live-…- Put the provider in
config.yaml. The ids listed undermodelsare only a first set; every id on the models page fits the same mapping:
# ~/.hermes/config.yamlmodel: default: glm-5.3-uncensored provider: custom:unrestrictable providers: unrestrictable: api: https://api.unrestrictable.ai/v1 key_env: UNRESTRICTABLE_API_KEY transport: chat_completions default_model: glm-5.3-uncensored models: glm-5.3-uncensored: {} glm-5.3-flash-uncensored: {} deepseek-v4.1-flash-abliterated: {} deepseek-v4-pro-uncensored: {} glm-5.3-abliterated: {} kimi-k3.1-pro-uncensored: {}- Start
hermesand type something. Within seconds the console’s usage page lists the request with its token counts and its charge.
Prefer the shell? These commands write the same block. A dotted path lands in config.yaml; an UPPER_SNAKE name lands in .env:
hermes config set UNRESTRICTABLE_API_KEY sk-unr-live-…hermes config set providers.unrestrictable.api https://api.unrestrictable.ai/v1hermes config set providers.unrestrictable.key_env UNRESTRICTABLE_API_KEYhermes config set providers.unrestrictable.transport chat_completionshermes config set model.provider custom:unrestrictablehermes config set model.default glm-5.3-uncensoredTo change model mid-session, use /model. Without --global the choice ends with the session; with it, Hermes writes the choice into config.yaml:
/model custom:unrestrictable:glm-5.3-flash-uncensored/model custom:unrestrictable:deepseek-v4.1-flash-abliterated --globalTo talk to the same models with nothing installed, open /chat in the browser.
Where everything lives
Two files under ~/.hermes/: config.yaml for settings and .env for secrets. Precedence runs CLI flags, then config.yaml, then .env, then the built-in defaults. The key_env field of a providers entry names the variable that holds the key, which keeps the key itself out of config.yaml. You may still meet a custom_providers list in older write-ups; Hermes reads it and hermes update converts it, but the mapping on this page is the current form.
Each key, explained
- api
- https://api.unrestrictable.ai/v1the endpoint including /v1; base_url works as an alias
- key_env
- UNRESTRICTABLE_API_KEYthe .env variable holding the full sk-unr- key
- transport
- chat_completionsthe OpenAI chat format; every build on the models page speaks it
- default_model
- glm-5.3-uncensoredthe id the entry opens with
- models
- id: {}settings per model, keyed by id; a context_length under an id replaces the detected value
- model.provider
- custom:unrestrictablepicks the entry; model.default names the starting id
Choosing the model
Each file read, shell command and subagent in Hermes is a tool call, so on an unfamiliar id give it one small task first and watch that a tool actually runs. Then look at input price: every turn resends the whole conversation plus all tool output, so input is what a session costs. The table prices a single turn, 30,000 tokens in and 1,000 out, using the catalog on 2026-11-16.
| Model | Per turn | Per 30 turns |
|---|---|---|
| GLM-5.3 Uncensored | $0.0093 | $0.28 |
| GLM-5.3 Flash Uncensored | $0.0035 | $0.11 |
| DeepSeek V4.1 Flash Abliterated | $0.03 | $0.81 |
| DeepSeek V4 Pro Uncensored | $0.03 | $0.93 |
| GLM-5.3 Abliterated | $0.07 | $2.10 |
| Kimi K3.1 Pro Uncensored | $0.04 | $1.22 |
| GLM-5.3 Uncensored | Uncensored | $0.282 | $0.846 |
| GLM-5.3 Flash Uncensored | Uncensored | $0.1053 | $0.3685 |
| DeepSeek V4.1 Flash Abliterated | Abliterated | $0.8488 | $1.6975 |
| DeepSeek V4 Pro Uncensored | Uncensored | $0.97 | $1.94 |
| GLM-5.3 Abliterated | Abliterated | $2.1825 | $4.365 |
| Kimi K3.1 Pro Uncensored | Uncensored | $1.164 | $5.82 |
If the work is code, the uncensored coding AI guide sets the code builds side by side and prices a whole day on each.
Test it
Run hermes status: it prints the model, the provider in use and which providers hold a credential, never the key itself. Then, in the same shell, ask the API for the model list with that key:
hermes statuscurl https://api.unrestrictable.ai/v1/models -H "Authorization: Bearer $UNRESTRICTABLE_API_KEY"Last, one request in Hermes’ own shape. The -i flag shows the headers: x-uplink-request-id identifies the request, and on a non-streamed reply x-uplink-charge states the cost in USD.
curl -i https://api.unrestrictable.ai/v1/chat/completions \ -H "Authorization: Bearer $UNRESTRICTABLE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "glm-5.3-uncensored", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with the single word ok."}]}'When it fails
401 invalid_api_key: the key is mistyped, revoked, or never reaches the request. Look in~/.hermes/.envfor the line, make surekey_envpoints at that variable, and paste the key from the console again.402 insufficient_balance: not enough balance for the call; add credit in the console.402 monthly_limit_reached: the key has reached the monthly limit you gave it.404 model_not_found:model.defaultholds an id the models page does not list. Copy one from the page and apply it throughhermes config set model.default <id>.429 rate_limited: your key’s own rate limit;retry-afterin the response says when to try again.- A
400on the very first run: the Hermes FAQ blames a mismatched model name. Runhermes config show, then holdmodel.defaultagainst the list on the models page. - No custom endpoint is read: a leftover
custom_providerskey inconfig.yaml, which is no longer a YAML list. Move it into theprovidersmapping shown here and runhermes doctor.
Where the facts come from
Field names are those of the providers page and the configuration guide in the Hermes Agent docs, both read 2026-11-06. Every price on this page is the live catalog’s at render time.
Questions
It does. A named entry under providers in ~/.hermes/config.yaml, with api, key_env and transport chat_completions, is all it takes. The YAML on this page aims that entry at https://api.unrestrictable.ai/v1, which puts every build on the models page within reach.
Either edit model.default (the id) and model.provider (custom:unrestrictable), or type /model custom:unrestrictable:<id> during a session; --global makes that stick in config.yaml. Paste the id from the models page instead of typing it.
On one line of ~/.hermes/.env: UNRESTRICTABLE_API_KEY=... An UPPER_SNAKE name given to hermes config set goes there as well. key_env in the providers entry points at it, so config.yaml holds no key.
Tokens times the model’s price, drawn from a prepaid balance; no subscription is needed. The table on this page prices an agent-sized turn on each build at today’s rate, and a repeated prefix is charged as cached input where the model has a cached rate.
Every model above is on the uncensored model list with its live price per million tokens. Per-token pricing sets the whole catalog side by side, and the family directory groups the builds by base model.