pola-rs/polars · error · ModuleUpgradeRequiredError

requires {module_root} {min_version} or higher (found {mod_v

Error message

requires {module_root} {min_version} or higher (found {mod_version})

What it means

ModuleUpgradeRequiredError raised by the lazy-import version gate: the optional dependency {module_root} is installed but its __version__ parses below the caller-supplied min_version, so the calling feature refuses to run until the package is upgraded.

Source

Thrown at py-polars/src/polars/_dependencies.py:309

    except ImportError:
        prefix = f"{err_prefix.strip(' ')} " if err_prefix else ""
        suffix = f" {err_suffix.strip(' ')}" if err_suffix else ""
        err_message = f"{prefix}'{module_name}'{suffix}.\n" + (
            install_message
            or f"Please install using the command `pip install {module_root}`."
        )
        raise ModuleNotFoundError(err_message) from None

    if min_version:
        min_version = parse_version(min_version)
        mod_version = parse_version(module.__version__)
        if mod_version < min_version:
            msg = (
                f"{min_err_prefix} {module_root} "
                f"{'.'.join(str(v) for v in min_version)} or higher"
                f" (found {'.'.join(str(v) for v in mod_version)})"
            )
            raise ModuleUpgradeRequiredError(msg)

    return module


__all__ = [
    # lazy-load rarely-used/heavy builtins (for fast startup)
    "dataclasses",
    "html",
    "json",
    "pickle",
    "subprocess",
    # lazy-load third party libs
    "altair",
    "boto3",
    "deltalake",
    "fsspec",
    "gevent",
    "great_tables",

View on GitHub (pinned to 9b5d73fd00)

Solutions

1. Upgrade the package: pip install -U <module_root> to reach the minimum required version.

Example fix

pip install -U pyarrow

When it happens

Trigger: An installed dependency is older than the required minimum version.

Common situations: See trigger scenarios.

AI-assisted analysis of pola-rs/polars@9b5d73fd00 (2026-08-19). Data as JSON: /api/errors/6de020646006bebd. Report an issue: GitHub.