Skip to main content
This guide outlines changes in LangGraph v1 and how to migrate from previous versions. For a high-level overview of changes, see the what’s new page. To upgrade:
pip install -U langgraph langchain-core

Summary of changes

LangGraph v1 is largely backwards compatible with previous versions. The main change is the deprecation of create_react_agent in favor of LangChain’s new create_agent function.

Deprecations

The following table lists all items deprecated in LangGraph v1:
Deprecated itemAlternative
create_react_agentlangchain.agents.create_agent
AgentStatelangchain.agents.AgentState
AgentStatePydanticlangchain.agents.AgentState (no more pydantic state)
AgentStateWithStructuredResponselangchain.agents.AgentState
AgentStateWithStructuredResponsePydanticlangchain.agents.AgentState (no more pydantic state)
HumanInterruptConfiglangchain.agents.middleware.human_in_the_loop.InterruptOnConfig
ActionRequestlangchain.agents.middleware.human_in_the_loop.InterruptOnConfig
HumanInterruptlangchain.agents.middleware.human_in_the_loop.HITLRequest
ValidationNodeTools automatically validate input with create_agent
MessageGraphStateGraph with a messages key, like create_agent provides

create_react_agentcreate_agent

LangGraph v1 deprecates the create_react_agent prebuilt. Use LangChain’s create_agent, which runs on LangGraph and adds a flexible middleware system. See the LangChain v1 docs for details:
from langchain.agents import create_agent

agent = create_agent(  
    model,
    tools,
    system_prompt="You are a helpful assistant.",
)

Breaking changes

Dropped Python 3.9 support

All LangChain packages now require Python 3.10 or higher. Python 3.9 reached end of life in October 2025.