langgraph

langchain-aiMIT活跃维护

用状态图编排有状态、可容错的 LLM Agent 工作流,支持循环、分支和人工介入,适合构建生产级多步智能体。

Build resilient agents.

sdk==0.4.14发布于 2026-11-06 03:03 UTC44,759star +161 / 7 天7,711fork同步于 2026-11-10 17:19 UTC

怎么上手

由 README 提炼,执行前请确认
pip install -U langgraph
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

LangGraph 是构建有状态智能体的底层编排框架,让长任务能持久运行、断点续跑

用状态图编排有状态、可容错的 LLM Agent 工作流,支持循环、分支和人工介入,适合构建生产级多步智能体。

核心能力

  • 用持久化执行让智能体失败后从断点自动恢复
  • 支持在任意执行点检查并修改状态实现人工介入
  • 提供短期工作记忆与跨会话长期持久记忆
  • 可接入 LangSmith 追踪执行路径与状态转换
  • 低层编排接口,可脱离 LangChain 独立使用

容易踩的坑

README 未说明具体依赖版本要求;调试与部署能力依赖 LangSmith 等配套产品,需另行接入;若想快速搭智能体,官方建议改用更高层的 Deep Agents 包

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本sdk==0.4.14
  1. cli==0.4.42langgraph-cli==0.4.422026-11-06 · 2026-11-06 03:04 UTC
    查看更新说明

    Changes since cli==0.4.41

    • release(cli): 0.4.42 (#9611)
    • feat(cli): add deploy metrics command (#9479)
    • chore(deps): bump filelock and langgraph-api for security fixes (#9606)
  2. sdk==0.4.14langgraph-sdk==0.4.14最新正式版2026-11-06 · 2026-11-06 03:03 UTC

    Changes since sdk==0.4.13

    • release(sdk-py): 0.4.14 (#9610)
    • feat(sdk-py): add strict_resume to runs.create, stream and wait (#9599)
    • feat(sdk-py): add tools and lifecycle to StreamMode (#9601)
  3. cli==0.4.41langgraph-cli==0.4.412026-11-05 · 2026-11-05 02:30 UTC
    查看更新说明

    Changes since cli==0.4.40

    • release(cli): 0.4.41 (#9596)
    • chore(deps): bump langgraph from 1.2.3 to 1.2.14 in /libs/cli (#9512)
    • chore(deps): bump the minor-and-patch group in /libs/cli/js-examples with 9 updates (#9528)
    • chore(deps): bump the minor-and-patch group in /libs/cli/js-monorepo-example with 8 updates (#9526)
    • chore(deps): bump the uv group across 2 directories with 1 update (#9513)
    • chore(deps): bump langgraph-sdk from 0.4.5 to 0.4.6 in /libs/cli (#9514)
    • fix(cli): remove outdated deploy private-beta notice (#9506)
    • chore(deps): bump zod from 4.3.6 to 4.6.7 in /libs/cli/js-monorepo-example (#9431)
  4. 1.2.20langgraph==1.2.202026-11-05 · 2026-11-05 02:20 UTC
    查看更新说明

    Changes since 1.2.19

    • release(langgraph): 1.2.20 (#9595)
    • feat(langgraph): give each interrupt() in a task its own id (#9589)
    • fix(langgraph): point the multiple-interrupts error at the current docs (#9590)
    • feat(langgraph): add a strict resume mode that refuses stale interrupt answers (#9574)
    • chore(deps-dev): bump types-requests from 2.33.0.20260906 to 2.33.0.20261006 in /libs/langgraph (#9535)
    • chore(deps-dev): bump pycryptodome from 3.23.0 to 4.2.0 in /libs/langgraph in the major group (#9534)
  5. sdk==0.4.13langgraph-sdk==0.4.132026-11-05 · 2026-11-05 02:16 UTC
    查看更新说明

    Changes since sdk==0.4.12

    • release(langgraph): 1.2.20 (#9595)
    • release(sdk-py): 0.4.13 (#9594)
    • feat(sdk-py): add cancel_reason to Run (#9571)
    • docs(sdk-py): show the run's status in the stream example's end event (#9588)
    • feat(sdk-py): add select to threads.get_state and get_history (#9568)

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Trusted by companies shaping the future of agents – including Klarna, Replit, Elastic, and more – LangGraph is a low-level orchestration framework for building, managing, and deploying long-running, stateful agents.

    pip install -U langgraph
    

    [!TIP] If you're looking to quickly build agents, check out Deep Agents — a higher-level package built on LangGraph for agents that can plan, use subagents, and leverage file systems for complex tasks.

    For an equivalent JS/TS library, check out LangGraph.js and the JS docs.

    Why use LangGraph?

    LangGraph provides low-level supporting infrastructure for any long-running, stateful workflow or agent:

    • Durable execution — Build agents that persist through failures and can run for extended periods, automatically resuming from exactly where they left off.
    • Human-in-the-loop — Seamlessly incorporate human oversight by inspecting and modifying agent state at any point during execution.
    • Comprehensive memory — Create truly stateful agents with both short-term working memory for ongoing reasoning and long-term persistent memory across sessions.
    • Debugging with LangSmith — Gain deep visibility into complex agent behavior with visualization tools that trace execution paths, capture state transitions, and provide detailed runtime metrics.
    • Production-ready deployment — Deploy sophisticated agent systems confidently with scalable infrastructure designed to handle the unique challenges of stateful, long-running workflows.

    [!TIP] For developing, debugging, and deploying AI agents and LLM applications, see LangSmith.

    LangGraph ecosystem

    While LangGraph can be used standalone, it also integrates seamlessly with any LangChain product, giving developers a full suite of tools for building agents.

    To improve your LLM application development, pair LangGraph with:

    • Deep Agents – Build agents that can plan, use subagents, and leverage file systems for complex tasks.
    • LangChain – Provides integrations and composable components to streamline LLM application development.
    • LangSmith – Helpful for agent evals and observability. Debug poor-performing LLM app runs, evaluate agent trajectories, gain visibility in production, and improve performance over time.
    • LangSmith Deployment – Deploy and scale agents effortlessly with a purpose-built deployment platform for long-running, stateful workflows. Discover, reuse, configure, and share agents across teams – and iterate quickly with visual prototyping in LangSmith Studio.

    Documentation

    Discussions: Visit the LangChain Forum to connect with the community and share all of your technical questions, ideas, and feedback.

    Additional resources

    • Guides – Quick, actionable code snippets for topics such as streaming, adding memory & persistence, and design patterns (e.g. branching, subgraphs, etc.).
    • LangChain Academy – Learn the basics of LangGraph in our free, structured course.
    • Case studies – Hear how industry leaders use LangGraph to ship AI applications at scale.
    • Contributing Guide – Learn how to contribute to LangChain projects and find good first issues.
    • Code of Conduct – Our community guidelines and standards for participation.

    Acknowledgements

    LangGraph is inspired by Pregel and Apache Beam. The public interface draws inspiration from NetworkX. LangGraph is built by LangChain Inc, the creators of LangChain, but can be used without LangChain.