NousResearch/hermes-agent · error · RuntimeError

{format_runtime_provider_error(exc)}

Error message

{format_runtime_provider_error(exc)}

What it means

Error "{format_runtime_provider_error(exc)}" thrown in NousResearch/hermes-agent.

Source

Thrown at gateway/platforms/api_server.py:341

        if value is None:
            continue
        runtime_kwargs[key] = list(value) if key == "args" and isinstance(value, (list, tuple)) else value
    return runtime_kwargs


def _resolve_request_runtime_agent_kwargs(provider: str, target_model: Optional[str] = None) -> Dict[str, Any]:
    """Resolve runtime kwargs for a one-request provider override.

    This mirrors gateway.run._resolve_runtime_agent_kwargs(), but accepts an
    explicit provider/model so an API caller can use the same authenticated
    provider catalog as the TUI without mutating config.yaml.
    """
    from hermes_cli.runtime_provider import resolve_runtime_provider, format_runtime_provider_error, _get_model_config

    try:
        runtime = resolve_runtime_provider(requested=provider, target_model=target_model)
    except Exception as exc:
        raise RuntimeError(format_runtime_provider_error(exc)) from exc

    model_cfg = _get_model_config()
    max_tokens = None
    env_max_tokens = os.environ.get("HERMES_MAX_TOKENS")
    if env_max_tokens:
        try:
            max_tokens = int(env_max_tokens)
        except (ValueError, TypeError):
            max_tokens = None
    elif isinstance(model_cfg, dict):
        cfg_max_tokens = model_cfg.get("max_tokens")
        if isinstance(cfg_max_tokens, int):
            max_tokens = cfg_max_tokens
    if max_tokens is None:
        runtime_max_tokens = runtime.get("max_output_tokens")
        if isinstance(runtime_max_tokens, int) and runtime_max_tokens > 0:
            max_tokens = runtime_max_tokens

View on GitHub (pinned to c896c09c42)

Solutions

1. Fix the provider/auth error shown (API key, model, base URL) and retry the request.
2. Run `hermes setup` or `hermes model` to repair the provider configuration.

When it happens

Trigger: Thrown at gateway/platforms/api_server.py:341 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/950460767c4cf143. Report an issue: GitHub.