langgraphjs

把语言代理画成图,轻松搞定复杂流程和状态管理

LangGraph.js 是一个用 TypeScript 编写的开源框架,用于将语言代理构建为图结构。它解决了复杂语言代理应用中状态管理、流程控制和可靠性不足的问题,通过将代理的推理步骤建模为有向图,使开发者能够精细控制执行流程、维护跨步骤状态,并实现循环、分支和人工介入等高级模式。核心能力包括:基于图的状态机设计、支持持久化与恢复、内置人机协作节点、以及可组合的模块化架构。它适用于构建需要多步骤推理、工具调用和动态决策的智能体应用,如客服机器人、研究助手和自动化工作流。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 3309
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队langchain-ai
所属国家
定价模式free
价格说明开源框架,MIT许可证,完全免费,可自行部署使用。
访问状态
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型agents,ai,artificial-intelligence,generative-ai,llm,node,typescript
GitHub 星标★ 3309
30天Star增速
HF 下载量
上线时间2024-01-09 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:进阶 约 10 分钟 部署方式:库/依赖 4 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Node.js 运行环境(LangGraph.js 为 TypeScript/JavaScript 库,通过 npm 分发)
  • npm 包管理器,用于安装 @langchain/langgraph
  • 具备 TypeScript 或 JavaScript 项目基础,用于编写代理图逻辑

安装与启动步骤

  1. 1检查 Node 环境

    先确认本机已安装 Node.js,LangGraph.js 是 npm 生态的 JS/TS 库,必须要有 Node 运行时。

    node -v
  2. 2初始化项目

    新建一个目录并生成 package.json,作为后续安装依赖和编写代理代码的工程基础。

    mkdir my-langgraph-app
    cd my-langgraph-app
    npm init -y
  3. 3安装 LangGraph.js

    从 npm 安装官方包 @langchain/langgraph,该包名来自 README 中链接的 npm 页面地址。

    npm install @langchain/langgraph
  4. 4查阅官方文档

    README 只给出概览与文档入口,具体 API、图构建方式、节点与状态定义请按官方文档操作。

如何确认成功

项目目录下 node_modules 中出现 @langchain/langgraph,且代码中能正常 import 该包不报错,即表示依赖安装成功。

常见问题

Q:LangGraph.js 和 LangChain 是什么关系?

A:README 说明 LangChain 提供集成与可组合组件来简化 LLM 应用开发,而 LangGraph 是更底层的编排框架,专注构建可控、有状态的代理。

Q:这个库需要单独部署服务吗?

A:不需要。它是一个 npm 库,安装后直接在你的 TypeScript/JavaScript 项目代码中引入使用,随项目一起运行。

Q:安装命令里的包名怎么确认?

A:README 徽章链接指向 npm 包 @langchain/langgraph,因此安装该包名。版本号 README 未固定,默认装最新版。

Q:想要更详细的使用示例去哪里看?

A:README 提供了官方文档地址 https://docs.langchain.com/oss/javascript/langgraph/overview,安装完成后按文档编写图与节点。

注意事项

  • README 节选未包含完整安装与快速开始代码,本教程的安装步骤基于其 npm 包信息与通用 npm 流程整理,请以官方文档为准。
  • README 未指定 Node.js 最低版本、端口或环境变量,请勿自行猜测版本号与密钥配置。
  • 该库用于构建有状态代理,涉及多步骤推理与工具调用,建议先阅读文档中的图、状态与检查点概念再动手。

核心亮点

  • 图结构可视化,流程清晰,便于调试和扩展
  • 内置状态持久化,支持断点续跑和人工审批
  • TypeScript 原生支持,类型安全,适合前端/全栈团队

不足之处

  • 学习曲线较陡,需要理解图论和状态机概念
  • 文档和示例相比 LangChain 生态偏少

适用场景

  • 构建多步骤客服机器人,需人工介入审核
  • 开发自动化研究助手,需动态调用工具并汇总结果
  • 实现复杂业务流程编排,如审批、分支和循环

替代项目

LangChain、Haystack、Semantic Kernel

项目介绍

langgraphjs 是开发框架领域的开源项目,由 langchain-ai 开发,2024 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(3,309)位列前 30%,在开发框架分类的 803 个项目里位列前 15%。

近 42 天,它的 GitHub 星标从 3,196 增加到 3,309,净增 113。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。MIT许可证,完全免费,可自行部署使用。

它主要面向的使用场景是:构建多步骤客服机器人,需人工介入审核。同类可对比的替代方案包括 LangChain、Haystack、Semantic Kernel。

上一篇:LangChain-ChatGLM-Webui

下一篇:markstream-vue

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12