langchain-ai/langgraph · error · ValueError

Could not load embeddings from string

Error message

Could not load embeddings from string '{embed}'. {version_info} loading embeddings by provider:identifier string requires langchain>=0.3.9 as well as the provider-specific package. Install LangChain with: pip install 'langchain>=0.3.9' and the provider-specific package (e.g., 'langchain-openai>=0.3.0'). Alternatively, specify 'embed' as a compatible Embeddings object or python function.

What it means

Error "Could not load embeddings from string '{embed}'. {version_info} loading embeddings by provider:identifier string requires langchain>=0.3.9 as well as the provider-specific package. Install LangChain with: pip install 'langchain>=0.3.9' and the provider-specific package (e.g., 'langchain-openai>=0.3.0'). Alternatively, specify 'embed' as a compatible Embeddings object or python function." thrown in langchain-ai/langgraph.

Solutions

1. Upgrade: pip install 'langchain>=0.3.9' plus the provider package (e.g. 'langchain-openai>=0.3.0')
2. Pass an Embeddings instance directly: ensure_embeddings(OpenAIEmbeddings())
3. Pass a plain Python embedding function instead of a provider:identifier string

When it happens

Trigger: Thrown at libs/checkpoint/langgraph/checkpoint/store/base/embed.py:94 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/8922b9851732c9e6. Report an issue: GitHub.

Appendix: source

Thrown at libs/checkpoint/langgraph/checkpoint/store/base/embed.py:94

    if isinstance(embed, str):
        init_embeddings = _get_init_embeddings()
        if init_embeddings is None:
            from importlib.metadata import PackageNotFoundError, version

            try:
                lc_version = version("langchain")
                version_info = f"Found langchain version {lc_version}, but"
            except PackageNotFoundError:
                version_info = "langchain is not installed;"

            raise ValueError(
                f"Could not load embeddings from string '{embed}'. {version_info} "
                "loading embeddings by provider:identifier string requires langchain>=0.3.9 "
                "as well as the provider-specific package. "
                "Install LangChain with: pip install 'langchain>=0.3.9' "
                "and the provider-specific package (e.g., 'langchain-openai>=0.3.0'). "
                "Alternatively, specify 'embed' as a compatible Embeddings object or python function."
            )
        return init_embeddings(embed)

View on GitHub (pinned to 38031739e5)