AnyAPI Plugin for Hermes Agent
Hermes Agent supports installable provider plugins. The AnyAPI.ai plugin registers AnyAPI as a selectable provider — alongside built-in providers — inhermes model, hermes setup, hermes doctor, and the --provider flag, so you don’t have to hand-write a custom_providers: block.
What it does
- Registers one
ProviderProfilenamedanyapi.ai(aliasany-api) via Hermes’sregister_providerhook. - Adds no tools and changes no core Hermes files.
- Filters the model picker to routes tagged for tool/function calling. If the catalog is unreachable, or the filter would leave nothing, it falls back to the unfiltered
/v1/modelslist.
Requirements
- Hermes Agent
>= 0.20.0 - Linux, macOS, or Windows
- An AnyAPI API key
Installation
1
Install the plugin
e5b7b98). It only updates when you install a new pinned version — there’s no auto-update.2
Set your API key
3
Select the provider
hermes model and pick anyapi.ai from the provider list.Configuration
Model IDs use the
vendor/model format, same as the rest of AnyAPI — e.g. anthropic/claude-sonnet-4.6, openai/gpt-4o. Browse the live catalog at anyapi.ai/ai-models or via the dashboard.
Because the model picker only lists routes tagged
function_calling, a model you expect to see may be filtered out if it doesn’t support tool calling. Use the manual custom_providers: setup if you need access to the full, unfiltered catalog.Data flow and permissions
Review this before installing any third-party plugin:Network access
Network access
One call to
https://api.anyapi.ai/v1/models to list models. All chat traffic you send through the anyapi.ai provider also goes to AnyAPI, which forwards it to the upstream vendor serving the selected model.Files and shell
Files and shell
The plugin reads no files, writes no files, and runs no shell commands.
Telemetry
Telemetry
The plugin itself collects none. This does not cover AnyAPI’s own request handling as your model relay — prompts, tool results, and your
ANYAPI_API_KEY are sent to api.anyapi.ai to be routed to the upstream model provider and billed to your AnyAPI account, same as any other AnyAPI request.Troubleshooting
Provider not found after install
Provider not found after install
Restart Hermes, then confirm the plugin is listed:If it’s missing, reinstall with
hermes plugins install anyapi.Authentication failed (HTTP 401)
Authentication failed (HTTP 401)
Verify
ANYAPI_API_KEY is set (grep ANYAPI ~/.hermes/.env) and that the key is active at dash.anyapi.ai.Expected model is missing from the picker
Expected model is missing from the picker
The picker only shows
function_calling-tagged routes. Either pick a tool-calling-capable model, or switch to the manual custom_providers: setup for the unfiltered catalog.Next Steps
Manual Hermes Integration
Configure AnyAPI as a custom provider without installing a plugin
All Integrations
Browse all supported tools
Support
- AnyAPI Dashboard: dash.anyapi.ai
- AnyAPI Discord: Discord community
- AnyAPI Email: support@anyapi.ai
- Plugin repository: github.com/es697/hermes-provider-anyapi