BerriAI/litellm · error · Exception

JavelinGuardrailException - Please pass the Javelin guard na

Error message

JavelinGuardrailException - Please pass the Javelin guard name via 'litellm_params::guard_name'

What it means

Error "JavelinGuardrailException - Please pass the Javelin guard name via 'litellm_params::guard_name'" thrown in BerriAI/litellm.

Source

Thrown at litellm/proxy/guardrails/guardrail_hooks/javelin/__init__.py:15

from typing import TYPE_CHECKING, Final

from litellm.types.guardrails import SupportedGuardrailIntegrations

from .javelin import JavelinGuardrail

if TYPE_CHECKING:
    from litellm.types.guardrails import Guardrail, LitellmParams


def initialize_guardrail(litellm_params: "LitellmParams", guardrail: "Guardrail"):
    import litellm

    if litellm_params.guard_name is None:
        raise Exception(
            "JavelinGuardrailException - Please pass the Javelin guard name via 'litellm_params::guard_name'"
        )

    _javelin_callback: Final = JavelinGuardrail(
        api_base=litellm_params.api_base,
        api_key=litellm_params.api_key,
        guardrail_name=guardrail.get("guardrail_name", ""),
        javelin_guard_name=litellm_params.guard_name,
        event_hook=litellm_params.mode,
        default_on=litellm_params.default_on or False,
        api_version=litellm_params.api_version or "v1",
        config=litellm_params.config,
        metadata=litellm_params.metadata,
        application=litellm_params.application,
    )
    litellm.logging_callback_manager.add_litellm_callback(_javelin_callback)

    return _javelin_callback

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Set guard_name under litellm_params in the javelin guardrail config.
2. Confirm the guard name exists in your Javelin application configuration.

When it happens

Trigger: Thrown at litellm/proxy/guardrails/guardrail_hooks/javelin/__init__.py:15 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/15ec1d5be7298a63. Report an issue: GitHub.