LangGraph v1 migration guide

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

uv add 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 item	Alternative
`create_react_agent`	`langchain.agents.create_agent`
`AgentState`	`langchain.agents.AgentState`
`AgentStatePydantic`	`langchain.agents.AgentState` (no more pydantic state)
`AgentStateWithStructuredResponse`	`langchain.agents.AgentState`
`AgentStateWithStructuredResponsePydantic`	`langchain.agents.AgentState` (no more pydantic state)
`HumanInterruptConfig`	`langchain.agents.middleware.human_in_the_loop.InterruptOnConfig`
`ActionRequest`	`langchain.agents.middleware.human_in_the_loop.InterruptOnConfig`
`HumanInterrupt`	`langchain.agents.middleware.human_in_the_loop.HITLRequest`
`ValidationNode`	Tools automatically validate input with `create_agent`
`MessageGraph`	`StateGraph` with a `messages` key, like `create_agent` provides

`create_react_agent` → `create_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.",
)

from langgraph.prebuilt import create_react_agent

agent = create_react_agent(  
    model,
    tools,
    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.

Edit the source of this page on GitHub.

Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.

Reference

Errors

Releases

Policies

Summary of changes

Deprecations

`create_react_agent` → `create_agent`

Breaking changes

Dropped Python 3.9 support

​Summary of changes

​Deprecations

​create_react_agent → create_agent

​Breaking changes

​Dropped Python 3.9 support

Summary of changes

Deprecations

`create_react_agent` → `create_agent`

Breaking changes

Dropped Python 3.9 support