NousResearch/hermes-agent · error · PluginLlmTrustError

Plugin {policy.plugin_id!r} cannot override the provider (se

Error message

Plugin {policy.plugin_id!r} cannot override the provider (set plugins.entries.{policy.plugin_id}.llm.allow_provider_override to true to allow).

What it means

Error "Plugin {policy.plugin_id!r} cannot override the provider (set plugins.entries.{policy.plugin_id}.llm.allow_provider_override to true to allow)." thrown in NousResearch/hermes-agent.

Source

Thrown at agent/plugin_llm.py:290

    requested_model: Optional[str],
    requested_agent_id: Optional[str],
    requested_profile: Optional[str],
) -> tuple[Optional[str], Optional[str], Optional[str], Optional[str]]:
    """Apply the trust gate. Returns the validated overrides as
    ``(provider, model, agent_id, profile)`` or raises
    :class:`PluginLlmTrustError`.

    Each override (``provider``, ``model``, ``agent_id``, ``profile``)
    is independently gated. ``provider`` and ``model`` each have an
    optional allowlist via ``allowed_providers`` / ``allowed_models``.
    """
    final_provider: Optional[str] = None
    final_model: Optional[str] = None
    final_profile: Optional[str] = None

    if requested_provider:
        if not policy.allow_provider_override:
            raise PluginLlmTrustError(
                f"Plugin {policy.plugin_id!r} cannot override the provider "
                f"(set plugins.entries.{policy.plugin_id}.llm.allow_provider_override "
                f"to true to allow)."
            )
        normalized = _normalize_ref(requested_provider)
        if (
            not policy.allow_any_provider
            and policy.allowed_providers is not None
            and normalized not in policy.allowed_providers
        ):
            raise PluginLlmTrustError(
                f"Plugin {policy.plugin_id!r} provider override "
                f"{requested_provider!r} is not in plugins.entries."
                f"{policy.plugin_id}.llm.allowed_providers."
            )
        final_provider = requested_provider.strip()

    if requested_model:

View on GitHub (pinned to c896c09c42)

Solutions

1. Set plugins.entries.<plugin>.llm.allow_provider_override to true in config.yaml to permit the override.
2. Remove the provider override from the plugin's completion request.

When it happens

Trigger: Thrown at agent/plugin_llm.py:290 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/a253d27d5e32584b. Report an issue: GitHub.