LangGraph
AI & LLMsBuild resilient language agents as graphs.
Release History
cli==0.4.311.2.91.2.81 fixThis release (1.2.8) primarily addresses a bug related to state updates in the delta channel and includes several dependency bumps across langgraph and the SDK.
1.2.73 fixesThis release (1.2.7) focuses primarily on dependency updates and several bug fixes within langgraph related to snapshotting, JSON serialization, and UUID generation for task IDs.
1.2.62 fixesThis release addresses regressions in langgraph regarding nested subgraph checkpointing and stream abort handling, alongside minor dependency updates.
cli==0.4.301 featureThis release introduces support for compatible API version ranges in the CLI and standardizes package README structure.
1.2.51 fixThis release includes minor updates across components, notably fixing a bug in state updates within langgraph and migrating internal type checking to 'ty'.
cli==0.4.291 featureThis release introduces HTTPS support for the development server via new configuration options.
cli==0.4.281 featureThis release updates several dependencies, including Starlette, TypeScript, Mypy, and UV, and migrates Python type checking to use 'ty'.
1.2.41 fixThis release includes a bug fix for langgraph ensuring backward compatibility for _on_started overrides. It also contains SDK integration tests.
1.2.34 fixes6 featuresThis release introduces significant streaming enhancements across langgraph and sdk-py, including v3 streaming support and new projection types, alongside several minor bug fixes.
sdk==0.4.21 fixThis release primarily addresses a bug fix related to percent-encoding the thread_id in the v3 stream transport paths.
sdk==0.4.11 fix2 featuresThis release introduces stream decoding capabilities and v3 streaming support for RemoteGraph, alongside a fix for the statelessness of the tools_agent fake model.
cli==0.4.272 fixesThis release focuses on dependency updates and minor fixes, including pinning internal Docker images and updating the API bound to 0.10.0.
sdk==0.4.015 featuresThis release introduces significant new streaming capabilities, including thread stream helpers, websocket transports, and v3 streaming primitives with SSE support. It also adds various sync and async features related to subgraphs, messages, and tool calls.
1.2.21 fixThis release bumps the langgraph version to 1.2.2 and includes a fix related to assigning stable IDs for checkpoint writes.
checkpoint==4.1.11 fixVersion 4.1.1 addresses a specific bug related to envelope revival and updates minor dependencies.
sdk==0.3.151 fix1 featureThe SDK has been updated to version 0.3.15, introducing metadata filtering for cron searches and fixing a URL encoding bug. Several underlying dependencies were also upgraded.
1.2.11 fix1 featureLangGraph version 1.2.1 introduces an opt-in feature for stream transformers and resolves a bug related to tool message inclusion in v3 messages. Dependency updates were also performed.
1.2.01 fix4 featuresThis release introduces durable error-handler resume in LangGraph and adds configuration options for checkpointing, alongside several dependency updates.
checkpointpostgres==3.1.01 fixThis release promotes alpha packages to official versions and includes a bug fix in checkpoint-postgres related to column aliasing in delta stage-2.
prebuilt==1.1.01 featureThis release promotes alpha packages to official versions and includes dependency bumps for urllib3, ty, and langchain-core. A new streaming walk implementation was added for SQLite checkpoints.
checkpointsqlite==3.1.01 featureThis release promotes alpha packages to official versions, updates dependencies like urllib3 and langchain-core, and introduces conformance documentation for the delta channel checkpointer in langgraph.
checkpoint==4.1.01 fix1 featureThis release promotes alpha packages to official versions, introduces forced delta channel snapshots in checkpointing, and fixes an issue with Reviver object specification. Several minor dependency updates were also performed.
cli==0.4.261 fixThis release of the CLI (0.4.26) primarily focuses on dependency updates and adds support for prerelease API versions.
cli==0.4.251 featureThis release bumps the CLI version and introduces support for studio deploy functionality. It also includes several dependency updates across various CLI examples.
checkpointsqlite==3.1.0a13 featuresThis release focuses on feature enhancements for checkpoint-sqlite, including overriding history retrieval and exposing a new saver API, alongside numerous dependency updates and alpha version bumps for related libraries.
sdk==0.3.144 featuresThis release primarily focuses on version bumps across several components, including alpha releases for langgraph and checkpoint modules, alongside minor feature additions like `return_minimal` for threads updates.
checkpointpostgres==3.1.0a42 featuresThis release bumps the alpha version for checkpoint-postgres to a4 and introduces a public API for retrieving write history along with a rework of the delta cadence.
1.2.0a72 featuresThis release bumps the alpha version for langgraph and checkpoint components and introduces a public API for saver history and delta cadence rework.
checkpoint==4.1.0a42 featuresThis release bumps the alpha version for langgraph and checkpoint packages and introduces a public API for getting writes history along with a rework of the delta cadence.
1.2.0a61 featureThis release bumps the alpha version of langgraph to 1.2.0a6 and introduces the ability to forward kwargs through stream_events(version="v3").
1.2.0a51 fixThis release bumps prebuilt and langgraph alpha versions and includes a fix for dict/str coercion in the langgraph delta reducer.
prebuilt==1.1.0a21 fixThis release bumps the alpha version for prebuilt to 1.1.0a2 and langgraph to 1.2.0a5, and includes a fix for scoping ToolCallTransformer projection.
1.2.0a4This release bumps the alpha versions for prebuilt to 1.1.0a1 and langgraph to 1.2.0a4.
prebuilt==1.1.0a1Breaking2 fixes2 featuresThis release bumps several packages to alpha versions, merges EventLog functionality into StreamChannel, and introduces streaming infrastructure to langgraph.
1.2.0a33 fixes7 featuresThis release introduces significant enhancements to langgraph, including node-level error handling, v2 projections, and streaming infrastructure, alongside various bug fixes and dependency updates.
checkpointpostgres==3.1.0a31 fixThis release bumps the alpha version for langgraph, checkpoint, and checkpoint-postgres packages and includes an optimization in langgraph regarding data transport.
checkpoint==4.1.0a31 fix1 featureThis release includes alpha updates for langgraph and checkpoint, featuring a new DeltaChannel capability, alongside a stable patch release for checkpoint addressing JSON blob handling.
checkpoint==4.1.0a21.2.0a22 fixes1 featureThis release introduces node-level error handlers in langgraph and fixes two related bugs concerning timeouts and stream projections.
checkpointpostgres==3.1.0a11 featureThis release focuses on dependency updates, particularly for checkpoint-postgres, and introduces a feature enhancement to langgraph's DeltaChannel for improved checkpoint handling.
prebuilt==1.0.131 fix1 featureThis release introduces streaming transformer infrastructure in langgraph and fixes a default configuration issue in prebuilt ToolRuntime tools. It also includes dependency updates and internal refactoring.
checkpoint==4.1.0a12 featuresThis release introduces alpha support for timers and enhances DeltaChannel functionality within langgraph by improving checkpoint handling.
1.2.0a11 fix5 featuresThis release introduces several enhancements to langgraph, including native v2 projections and improved streaming infrastructure, alongside general maintenance and dependency updates.
1.1.101 fix1 featureThis release includes dependency updates, a feature allowing ToolNodes to return multiple message types, and reverts a recent change regarding node-level timeouts.
prebuilt==1.0.121 fixThis release updates the prebuilt package to 1.0.12, langgraph to 1.1.10, and checkpoint to 4.0.3, while fixing a state hydration issue in ToolNode.
checkpoint==4.0.31 fixThis release focuses on fixing an issue related to JSON blob handling and updates the dependency on langsmith.
prebuilt==1.0.112 featuresPrebuilt package version 1.0.11 was released, introducing enhancements to ToolNode return types and exposing tools on ToolRuntime. LangChain core dependencies were also updated.
cli==0.4.24This release primarily contains maintenance chores, including minor formatting adjustments and dependency bumps across several directories.
1.1.91 fixThis release primarily focuses on a minor version bump for langgraph and includes a specific bug fix related to state propagation in subgraphs.
1.1.81 fixThis release primarily addresses a bug in langgraph related to type checking that interfered with OTel instrumentation, alongside minor version bumps for other components.
prebuilt==1.0.101 fix1 featureThis release includes updates across several components, notably bumping dependencies like langsmith and pytest, and fixing an issue related to handling injected NotRequired keys in prebuilt components.
cli==0.4.23This release updates the cli package to version 0.4.23.
1.1.71 fixThis release includes a bug fix for time travel in langgraph and updates the langsmith dependency version.
cli==0.4.22This release focuses on internal maintenance, including bumping the CLI version and updating several dependencies like langsmith, langchain-core, uv, and cryptography.
checkpoint==4.0.21 fixThis release primarily focuses on dependency updates within the checkpoint library and includes one bug fix related to task batching in checkpoints. Documentation for checkpoint security via LANGGRAPH_STRICT_MSGPACK was also added.
1.1.7a21 fix1 featureThis release introduces the ability to pass metadata solely for tracing and fixes an issue where assistant_id was incorrectly populated from metadata instead of configuration.
1.1.7a11 featureThis release introduces graph lifecycle callback handlers to langgraph and updates minor dependencies.
cli==0.4.211 featureThis release introduces a new "validate" command to the CLI tool.
cli==0.4.201 fix1 featureThis release introduces remote build support for langgraph deployment and fixes an issue with persisting deployment names. It also includes numerous dependency updates across various components.
sdk==0.3.131 featureThis release introduces the `langsmith_tracing` parameter for run operations in the Python SDK and updates several core dependencies, including Starlette to version 1.0.0.
1.1.61 fixLangGraph version 1.1.6 has been released, primarily addressing a bug fix concerning execution info patching.
1.1.52 fixes2 featuresThis release enhances runtime visibility and introduces remote build support for langgraph deployments via the CLI. It also includes minor documentation fixes.
prebuilt==1.0.91 fix1 featureThis release bumps prebuilt to 1.0.9 and langgraph to 1.1.5, introducing enhanced runtime execution information and fixing a tool node injection bug. It also includes numerous dependency updates.
1.1.41 fix1 featureVersion 1.1.4 for langgraph includes a fix for a recursion limit collision and adds LangSmith integration metadata.
cli==0.4.191 featureThis release introduces a new command for listing deployment revisions and updates several internal dependencies within the CLI examples and core library.
1.1.31 featureThis release includes dependency bumps across several libraries, notably updating pyjwt and orjson, and introduces execution information to the runtime.
sdk==0.3.12This release primarily consists of version bumps for the SDK and LangGraph components, updating them to versions 0.3.12 and 1.1.3 respectively.
checkpointpostgres==3.0.51 fix1 featureVersion 3.0.5 for checkpoint-postgres includes a fix to re-use connections and adds support for serde events across related components.
cli==0.4.181 fixThis release primarily updates an error message within the CLI component.
cli==0.4.171 featureThis release introduces new deep agent templates for the CLI utility.
cli==0.4.162 fixes3 featuresThis release of the CLI introduces new subcommands for managing langgraph deployments, including logs, list, and delete, alongside fixes for deployment tagging and client creation.
1.1.21 fix1 featureThis release (1.1.2) introduces context support for the remote graph API and fixes an issue with stream part generic ordering.
1.1.11 fixVersion 1.1.1 addresses a specific replay bug within langgraph and includes minor chore updates.
sdk==0.3.111 featureThis release introduces timezone support for cron expressions in the SDK and includes dependency updates.
1.1.01 fix4 featuresLangGraph 1.1 introduces an opt-in `version="v2"` format for `invoke` and `stream` methods, enabling full type safety and automatic output coercion for Pydantic/dataclass states. A bug fix was also implemented for subgraph replay behavior.
cli==0.4.151 fix1 featureThis release introduces langgraph deployment capabilities to the CLI and patches a security vulnerability related to shell injection in build/install commands.
sdk==0.3.101 featureThis release focuses on improving type safety for streaming and invocation, alongside general maintenance updates and caching additions.
cli==0.4.143 fixes1 featureThis release focuses heavily on dependency updates to address various CVEs and includes feature enhancements like the 'keep_latest' prune strategy for ThreadTTLConfig, alongside schema updates for the graph configuration.
checkpoint==4.0.11 featureThis release introduces the addition of serde events and bumps the version to 0.4.1.
1.0.10This release primarily consists of internal maintenance, dependency updates, and version bumps for langgraph and checkpoint sub-packages.
checkpoint==4.0.1rc3This release primarily consists of chore updates, including updating default settings and adding support for workflow dispatch in CI.
checkpoint==4.0.1rc2This release is a release candidate (rc2) and includes an improvement to subclass handling.
checkpoint==4.0.1rc1This release primarily focuses on dependency updates, conformance testing, and minor documentation clarity improvements.
1.0.10rc11 fixThis release focuses on internal improvements, adding type checking targets, and fixing a specific bubbling issue within langgraph related to checkpoint namespaces.
sdk==0.3.91 featureThis release introduces a new 'extract' parameter for the threads.search() method and adds a type checking target to the build process.
sdk==0.3.82 featuresThis release introduces new streaming and durability options for crons and enhances type safety for store authentication within the SDK.
1.0.91 fix1 featureThis release introduces langgraph prebuilt components and fixes an issue related to sequential interrupt handling in the functional API. It also includes several dependency bumps and minor internal refactoring.
prebuilt==1.0.81 fix1 featureThis release introduces integration with langgraph and fixes an issue related to dynamically registered tool injection. It also includes several dependency updates.
sdk==0.3.71 fixThis release focuses on minor fixes, including allowing configuration resets during assistant updates, and dependency bumps for internal libraries.
sdk==0.3.61 featureThis release introduces a new prune method and includes internal reorganization of client files.
sdk==0.3.5This release includes a chore update related to the server runtime type.
1.0.81 fixThis release includes a fix for double streaming in pydantic messages and various documentation enhancements across the SDK and CLI.
sdk==0.3.42 featuresThis release introduces new functionality for managing crons, including an update method and enabling/disabling capabilities, alongside dependency updates.
checkpointpostgres==3.0.4This release primarily contains maintenance updates, including dependency upgrades and minor chore changes like omitting the lock file when using a connection pool and updating Twitter URLs.
cli==0.4.12This release primarily updates dependencies and corrects outdated Twitter URLs within the CLI tool.
1.0.7Breaking1 fixVersion 1.0.7 includes dependency upgrades and a critical fix addressing a breaking change introduced in aiosqlite. Twitter URLs were also updated.
prebuilt==1.0.7Breaking1 fix1 featureThis release updates the prebuilt package to version 1.0.7, introducing dynamic tool calling support and fixing a bug related to aiosqlite.
checkpointsqlite==3.0.31 fixThis release primarily addresses a breaking change introduced by aiosqlite and includes dependency upgrades.
Common Errors
ModuleNotFoundError7 reportsThe "ModuleNotFoundError" in LangGraph usually indicates that required dependencies or LangGraph submodules are missing or not correctly installed. To fix this, ensure you've installed LangGraph and its dependencies using `pip install langgraph` (or `pip install "langgraph[all]"` for optional dependencies); try upgrading LangGraph to the latest version (`pip install --upgrade langgraph`) to resolve potential version-related issues. If the problem persists, double-check your Python environment and virtual environment activation.
BadRequestError6 reportsBadRequestError in langgraph usually arises from malformed requests to an external service, often an LLM, due to incorrect parameters or data. To fix it, carefully inspect the LLM's API call for configuration errors like conflicting parameters (e.g., both `max_tokens` and `max_completion_tokens`), invalid data types, or exceeding rate limits; correct any discrepancies or adjust input data to match the API's expected format. Ensure also that your loop termination condition is correctly defined in the graph.
UnicodeDecodeError3 reportsThis error typically occurs in langgraph. Check the example issues for common solutions.
NotImplementedError2 reportsThe "NotImplementedError" in LangGraph commonly arises when a required method or function within a custom class or component (like a custom Tool or Agent) is not defined. To fix this, identify the missing method (usually indicated in the error traceback) and implement its functionality within your custom class. Ensure your custom components align with the expected interface for proper execution within the LangGraph framework.
TypeError2 reportsThis TypeError usually arises when your LangGraph configuration, especially within the node context or checkpointing mechanism, attempts to serialize Python objects that aren't natively JSON serializable (e.g., custom classes, database connections, or complex objects). To fix it, either convert these problematic objects into JSON-serializable formats (like strings, dictionaries, or lists) before they enter the context or checkpoint storage, or implement a custom serialization/deserialization strategy for these object types if they must be persisted. Consider using libraries like `jsonpickle` if you have complex object graphs.
GraphLoadError2 reportsGraphLoadError in LangGraph often arises from missing or incorrect Python dependencies required by your graph's nodes and edges. Ensure all necessary packages, including those specified in `requirements.txt` or within your code (e.g., imports), are correctly installed using `pip install -r requirements.txt` (or equivalent) before running LangGraph. Consider utilizing a virtual environment to manage your project's dependencies and avoid conflicts with system-level packages. Double-check package names and versions for typos and compatibility.
Related AI & LLMs Packages
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
Get up and running with OpenAI gpt-oss, DeepSeek-R1, Gemma 3 and other models.
🦜🔗 The platform for reliable agents.
The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.
LLM inference in C/C++
GPT4All: Run Local LLMs on Any Device. Open-source and available for commercial use.
Subscribe to Updates
Get notified when new versions are released