Skip to content
LgPy

LangGraph

Stateful, graph-based agents for LLM apps — pick your language.

Low-level orchestration for stateful, long-running LLM agents. Explicit state, durable checkpoints, conditional routing, human-in-the-loop. Available in Python and TypeScript with the same concepts.

Current versions: Python langgraph 1.2.22 · TypeScript @langchain/langgraph 1.7.4 (checked 2026-11-19).

Core concepts

State, nodes, edges, compilation — the four primitives.

Multi-agent

Supervisor, parallel workers, handoff patterns.

Memory

Checkpointers for short-term, Stores for cross-thread memory.

Middleware

Agent middleware on createAgent / create_agent for guardrails, approvals, limits and logging.

Human-in-the-loop

Interrupts, multi-stage approvals, time-travel debugging.

Production

LangSmith Deployment and the langgraph CLI, durable checkpointers, testing, observability.

  • Python has the larger ecosystem, more recipes, and a ten-chapter tutorial.
  • TypeScript suits apps that are already Node or browser based; the primitives are the same and the builder is fully typed.

DateVersionChanges
2026-10-25Py 1.2.17 / TS 1.5.2Version bump: langgraph 1.2.17, langgraph-sdk 0.4.9, langchain 1.4.7, langchain-core 1.7.0; JS langchain 1.5.19 and @langchain/core 1.3.0 (tool-call arguments now stream as tool-call-delta slices). Examples re-checked.
2026-10-21Py 1.2.16 / TS 1.5.2Python agent pages moved to create_agent and middleware; the comprehensive page became an API map; production, performance and error-recovery pages rewritten; behavioural errors corrected (recursion limit, ToolNode errors, interrupts, TTL, durability). TypeScript: interrupts, Send, Command, subgraphs, Functional API, time travel and testing added; examples type-check under strict. Validation report page removed.
2026-10-21Py 1.2.16 / TS 1.5.2Current versions now come from the site’s version data. TypeScript guide brought up from 1.3.5 to 1.5.2 and its examples corrected (the @langgraphjs/toolkit recommendation removed; createAgent from langchain replaces createReactAgent). Python guide: invented production-patterns section replaced, AgentExecutor examples replaced, import paths and install advice corrected.
2026-09-14Py 1.2.11 / TS 1.3.5Source-verified rewrite: ch2 expanded to 6 patterns (MessagesState, create_react_agent, tools_condition, multi-mode streaming); ch8 completely rewritten — langchain.agents.middleware and langchain.agents.create_agent exist in the separate langchain package (not bundled with langgraph); ch8 documents the pre_model_hook/post_model_hook hooks available in langgraph standalone, plus per-node error_handler/retry_policy/timeout/cache_policy, set_node_defaults, and ToolNode(handle_tool_errors=...) — all verified against installed langgraph 1.2.11 source. Note: create_react_agent is deprecated per official LangGraph v1 migration docs in favour of langchain.agents.create_agent.
2026-09-08Py 1.2.11 / TS 1.3.5Consistency sweep. TypeScript card corrected 1.3.0 → 1.3.5; the TypeScript observability and streaming pages moved off a stale 1.0.2 “Latest” stamp; every Latest: stamp now names its package. Tables of contents on the TypeScript pages trimmed to sections that exist. No package installation or symbol verification performed.
2026-08-24Python 1.2.11 / TS 1.3.0Python updated to 1.2.11; ch1 version bump; ch4 added ToolInvocationError with interceptor example; ch6 added experimental v3 stream_events API (GraphRunStream, SubgraphRunStream, LifecyclePayload, StreamChannel); ch10 added set_node_defaults() with graph-wide policy defaults.
2026-06-22Python 1.2.6 / TS 1.3.0Python updated to 1.2.6; ch6 expanded with all 7 stream modes, typed StreamPart, GraphOutput; ch10 expanded with RetryPolicy, TimeoutPolicy, CachePolicy, Durability, IsLastStep, Topic channels, Send timeout.
2026-05-05Python 1.1.10 / TS 1.3.0TypeScript card updated to v1.3.0 with new description.
2026-04-21Python 1.1.8 / TS 1.2.9Parent index redesigned as language selector.
April 16, 2026Python 1.1.6 / TS 1.2.8Python 3.9 dropped; type-safe v2 API.
November 2025Python 1.0.3 / TS 1.0.2Initial multi-language guide.