LangGraph v1 migration guide ↗

Documentation Index#

Fetch the complete documentation index at: https://docs.langchain.com/llms.txt Use this file to discover all available pages before exploring further.

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:

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:

• Release notes

• Migration guide

  from langchain.agents import create_agent
  
  agent = create_agent(  # [!code highlight]
      model,
      tools,
      system_prompt="You are a helpful assistant.",
  )

  from langgraph.prebuilt import create_react_agent
  
  agent = create_react_agent(  # [!code highlight]
      model,
      tools,
      prompt="You are a helpful assistant.",  # [!code highlight]
  )

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 this page on GitHub or file an issue.

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