8.5

Migration from 0.x, and stale advice

Most 0.x code moved to langchain-classic or changed its name, and old advice survives in tutorials, notebooks, and some docs pages, so check each import against the pin.

You open a project from 2024. It imports AgentExecutor from langchain.agents, a loader from langchain_community, and MultiServerMCPClient from langchain_mcp_adapters. On langchain 1.5.0 the first import fails, the second comes from a package that is sunset, and the third conflicts with langchain[mcp].

When you finish this section, you can move 0.x code to the 1.x names, and tell a stale page or notebook from a current one.

The support window

LangChain 0.3 is in maintenance until December 2026, according to the release policy. The line still gets releases: langchain 0.3.30 and langchain-core 0.3.86 came on 2026-05-07, by the release dates on PyPI. langchain 0.3.30 carries the hardening of loads and dumps. langchain-core 0.3.86 fixes a path traversal, CVE-2026-34070. So 0.3 code runs today, and its security fixes stop after 2026.

The same policy says that a minor upgrade inside 1.x breaks nothing. Two minor releases changed what an upgrader must do. langchain 1.5.0 raised the Python floor to 3.11, as section 3.1 shows. langchain-core 1.7.0 changed streamed tool call arguments from snapshots to slices, by the release notes of langchain-core 1.7.0. Pin the versions in a lockfile, and read the changelog of each minor before you raise it.

Package lineLowest Python
0.33.9
langchain 1.0 to 1.4, langchain-core 1.0 to 1.7, by the PyPI metadata3.10
langchain 1.5.0, langchain-core 1.8.0, langchain-openai 1.8.0, and deepagents 0.7.383.11
langchain-anthropic 1.7.10 and langchain-ollama 1.1.03.10
langgraph 1.2.22, its checkpointers, and langsmith 0.14.173.10

Imports that moved

0.x importAt the pinSection
from langchain.chains import LLMChainlangchain_classic.chains, deprecated since 0.1.17 with removal in 2.0.03.1
from langchain.agents import AgentExecutor, initialize_agentlangchain_classic.agents, and initialize_agent is deprecated. New agents use langchain.agents.create_agent4.1
from langchain import hublangchain_classic.hub, and its push and pull are deprecated for the LangSmith SDK3.5
langchain.retrievers.MultiQueryRetriever, RetrievalQAlangchain-classic. BaseRetriever stays in langchain_core.retrievers7.1
langchain_community.*sunset at 0.4.2, with an archived repository. Use the provider package where one exists3.1
from langchain_mcp_adapters.client import MultiServerMCPClientlangchain.mcp.MCPAdapter, in beta, installed with langchain[mcp]7.3
from langgraph.prebuilt import create_react_agentlangchain.agents.create_agent. The old function still imports and warns4.1
from langgraph.checkpoint.memory import MemorySaverInMemorySaver. MemorySaver remains as an alias5.2
from langgraph.errors import NodeInterruptlanggraph.types.interrupt, and resume with Command(resume=...)6.4
from langgraph.constants import Sendfrom langgraph.types import Send6.2

The repository of the LangSmith SDK also moved, to langchain-ai/langsmith-python. The package name langsmith did not change.

create_react_agent to create_agent

The migration guide of the v1 release lists each argument that changed. We checked each row against the code at the pin.

create_react_agentcreate_agent
prompt=system_prompt=, a string or a SystemMessage
a callable promptthe @dynamic_prompt middleware
pre_model_hook, post_model_hookbefore_model and after_model middleware
a Pydantic or dataclass statea TypedDict that extends AgentState, through state_schema
a model chosen by a callablewrap_model_call middleware with request.override(model=...)
a model with bind_tools already callednot in the signature, which takes a string or a chat model, and not checked. Pass the plain model and the tools
ToolNode(handle_tool_errors=...)ToolErrorMiddleware(on_error), or wrap_tool_call middleware
response_format in an extra final nodestructured output in the main loop, with ToolStrategy, ProviderStrategy, or AutoStrategy
the node name agent in a streammodel
static data in config["configurable"]context= on invoke, typed by context_schema
the recursion limit of LangGraph9999 steps, set by create_agent

Section 4.1 shows the graph that create_agent builds, and section 4.5 shows the hooks that replace the old ones.

LangGraph names that changed

Two deprecations show up in the kit as warnings. The first comes from a graph run with the old argument checkpoint_during:

outputcheckpoint_during at the pinFull log
warning LangGraphDeprecatedSinceV10: `checkpoint_during` is deprecated and will be removed. Please use `durability` instead. Deprecated in LangGraph V1.0 to be removed in V2.0.

The second comes from reading the output of invoke(version="v2") as a dict:

outputa dict read of GraphOutputFull log
warning LangGraphDeprecatedSinceV11: Accessing GraphOutput via `result[key]` is deprecated. Use `result.value` to access the output value directly, or `result.interrupts` for interrupts. Deprecated in LangGraph V1.1 to be removed in V3.0.

Three more changes have no warning, and old code reads them wrong:

  • The recursion limit. Old advice names 25. At the pin, a StateGraph stops at 10007 steps and create_agent at 9999. Section 6.8 gives both.
  • Interrupt. The fields ns, when, and resumable are gone, and interrupt_id gave way to id in 0.6.0.
  • Deep Agents 0.7.0. create_deep_agent no longer adds TodoListMiddleware, so write_todos is not a default tool. Section 7.4 shows the default tool set.

Stale pages in the docs

The docs site serves its main branch, so most pages describe the pin or a newer state. We searched every docs page that we saved for old names, such as AgentExecutor, initialize_agent, create_react_agent, MultiServerMCPClient, and LangGraph Platform. The first two and the old platform names had no hit. The others appeared only on migration and release pages, which is where they belong.

These pages still teach an older state at docs commit 04d4d4a. Each one has an entry in the conflict register of this manual.

PageWhat is out of dateConflict
oss/python/langchain/install and oss/python/release-policyPython 3.10 as the floorD101
oss/python/releases/langchain-v1the list of providers with content blocks, and the namespace table without langchain.mcpD117
both v1 release pagesa link for create_react_agent that goes to the function of the same name in langchain-classicD107
langsmith/faqa table that calls checkpointers community code and streaming basicD108
langsmith/manage-prompts-programmaticallythe hub through langchain_classic and a prompt piped into a modelD113
langsmith/trace-with-langchainan LCEL chain as the first exampleD114
oss/python/deepagents/overviewplanning named as a default in its first paragraphD109
oss/python/langgraph/local-serverthe old name LangGraph StudioD116

Old notebooks and tutorials

A notebook or a tutorial runs on the versions that its author locked. A floor such as langchain>=0.3.9 lets pip install 1.5.0, so the code then runs on a line that its author never tested. Read the lockfile first, then run the code with warnings shown. The table of moved imports above gives the fix for each old name.

Two of those old names still import at the pin and warn. NodeInterrupt warns that it is deprecated and points to interrupt. An import of Send from langgraph.constants warns and points to langgraph.types.

Static interrupt_before on compile is not stale, because compile still accepts it. Teach interrupt() first, and keep interrupt_before for debugging.

LangChain (Python): langchain, langchain-core, langgraph, deepagents, langsmith 1.5.0 · c2f4036 · 2026-11-11 · Edition 2026.11