microsoft/graphrag · error · ValueError

tokens_per_period must be a positive integer for Sliding Win

Error message

tokens_per_period must be a positive integer for Sliding Window rate limit.

What it means

When tokens_per_period is provided for the Sliding Window limiter, it must be > 0. Zero or negative token budgets are invalid and rejected by RateLimitConfig validation.

Source

Thrown at packages/graphrag-llm/graphrag_llm/config/rate_limit_config.py:53

    )

    def _validate_sliding_window_config(self) -> None:
        """Validate Sliding Window rate limit configuration."""
        if self.period_in_seconds is not None and self.period_in_seconds <= 0:
            msg = "period_in_seconds must be a positive integer for Sliding Window rate limit."
            raise ValueError(msg)

        if not self.requests_per_period and not self.tokens_per_period:
            msg = "At least one of requests_per_period or tokens_per_period must be specified for Sliding Window rate limit."
            raise ValueError(msg)

        if self.requests_per_period is not None and self.requests_per_period <= 0:
            msg = "requests_per_period must be a positive integer for Sliding Window rate limit."
            raise ValueError(msg)

        if self.tokens_per_period is not None and self.tokens_per_period <= 0:
            msg = "tokens_per_period must be a positive integer for Sliding Window rate limit."
            raise ValueError(msg)

    @model_validator(mode="after")
    def _validate_model(self):
        """Validate the rate limit configuration based on its type."""
        if self.type == RateLimitType.SlidingWindow:
            self._validate_sliding_window_config()
        return self

View on GitHub (pinned to f40e9a26ce)

Solutions

Set tokens_per_period to a positive integer matching your quota (e.g. 120000)
If you only want request limiting, omit tokens_per_period and set requests_per_period

Example fix

# before
RateLimitConfig(type="sliding_window", tokens_per_period=0, requests_per_period=10)
# after
RateLimitConfig(type="sliding_window", requests_per_period=10, period_in_seconds=60)

Defensive patterns

Strategy: validation

Validate before calling

tpp = rl.get("tokens_per_period")
if tpp is not None and tpp <= 0:
    raise ValueError("tokens_per_period must be > 0")

Prevention

Copy TPM/RPM quotas from the provider portal as positive integers
Omit rather than zero-out limits you don't want

When it happens

Trigger: RateLimitConfig(type=RateLimitType.SlidingWindow, tokens_per_period=0) or a negative value in settings.

Common situations: Placeholder 0 intended to disable token limiting (omit the field instead); mis-tuned TPM copied from a quota table with 0 for tiers without a token limit.

Understand the failure class

Background: "Invalid value" and "allowed values are" config errors: what your library rejected and how to fix it — this error's family across 41 libraries.

Related errors

AI-assisted analysis of microsoft/graphrag@f40e9a26ce (2026-08-27). Data as JSON: /api/errors/28491ec903be543d. Report an issue: GitHub.