BerriAI/litellm · error · ValueError

Tag budgets are an Enterprise only feature, {CommonProxyErro

Error message

Tag budgets are an Enterprise only feature, {CommonProxyErrors.not_premium_user}

What it means

Raised in _init_tag_budgets when litellm.tag_budget_config is set but the deployment is not running with a valid enterprise license; tag budgets are a premium feature gated by CommonProxyErrors.not_premium_user.

Source

Thrown at litellm/router_strategy/budget_limiter.py:829

        """
        Register or refresh deployment-level budget config for a runtime-added deployment.
        """
        self._init_deployment_budgets(model_list=[deployment])

    def unregister_deployment_budget(self, model_id: str) -> None:
        if self.deployment_budget_config is None:
            return
        self.deployment_budget_config.pop(model_id, None)
        if len(self.deployment_budget_config) == 0:
            self.deployment_budget_config = None

    def _init_tag_budgets(self):
        if litellm.tag_budget_config is None:
            return
        from litellm.proxy.proxy_server import CommonProxyErrors, premium_user

        if premium_user is not True:
            raise ValueError(f"Tag budgets are an Enterprise only feature, {CommonProxyErrors.not_premium_user}")

        if self.tag_budget_config is None:
            self.tag_budget_config = {}

        for _tag, _tag_budget_config in litellm.tag_budget_config.items():
            if isinstance(_tag_budget_config, dict):
                _tag_budget_config = BudgetConfig(**_tag_budget_config)
            _generic_budget_config = GenericBudgetInfo(
                time_period=_tag_budget_config.budget_duration,
                budget_limit=_tag_budget_config.max_budget,
            )
            self.tag_budget_config[_tag] = _generic_budget_config

        verbose_router_logger.debug("Initialized Tag Budget Config: %s", self.tag_budget_config)

View on GitHub (pinned to 77b7c6c40c)

Solutions

  1. Set LITELLM_LICENSE to a valid Enterprise license to use tag budgets.
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at litellm/router_strategy/budget_limiter.py:829 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/8f63e1f9d27d2408. Report an issue: GitHub.