langchain-ai/langgraph · error · FileNotFoundError

Checkpointer file not found: {resolved} (from {path_str})

Error message

Checkpointer file not found: {resolved} (from {path_str})

What it means

Error "Checkpointer file not found: {resolved} (from {path_str})" thrown in langchain-ai/langgraph.

Source

Thrown at libs/cli/langgraph_cli/config.py:1027

def _update_checkpointer_path(
    config_path: pathlib.Path, config: Config, local_deps: LocalDeps
) -> None:
    """Update checkpointer.path to use Docker container paths."""
    checkpointer_conf = config.get("checkpointer")
    if not checkpointer_conf or not isinstance(checkpointer_conf, dict):
        return
    if not (path_str := checkpointer_conf.get("path")):
        return

    module_str, sep, attr_str = path_str.partition(":")
    if not sep or not module_str.startswith("."):
        return  # Already validated or absolute path

    resolved = config_path.parent / module_str
    if not resolved.exists():
        raise FileNotFoundError(
            f"Checkpointer file not found: {resolved} (from {path_str})"
        )
    if not resolved.is_file():
        raise IsADirectoryError(f"Checkpointer path must be a file: {resolved}")

    # Check faux packages first (higher priority)
    for faux_path, (_, destpath) in local_deps.faux_pkgs.items():
        if resolved.is_relative_to(faux_path):
            new_path = f"{destpath}/{resolved.relative_to(faux_path)}:{attr_str}"
            checkpointer_conf["path"] = new_path
            return

    # Check real packages
    for real_path in local_deps.real_pkgs:
        if resolved.is_relative_to(real_path):
            new_path = (
                f"/deps/{real_path.name}/{resolved.relative_to(real_path)}:{attr_str}"
            )

View on GitHub (pinned to 38031739e5)

When it happens

Trigger: Thrown at libs/cli/langgraph_cli/config.py:1027 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of langchain-ai/langgraph@38031739e5 (2026-08-26). Data as JSON: /api/errors/f9a6fae94cf13a60. Report an issue: GitHub.