Skip to main content
本指南向你展示如何在本地运行 LangGraph 应用程序。

​
前提条件

开始之前，请确保你已具备以下条件：
  • 一个 LangSmith 的 API 密钥 - 免费注册

​
1. 安装 LangGraph CLI

​
2. 创建 LangGraph 应用

从 new-langgraph-project-js 模板 创建一个新应用。此模板演示了一个单节点应用，你可以使用自己的逻辑进行扩展。
如果你有一个包含 LangGraph 代理的现有项目，可以使用 config 命令自动生成 langgraph.json 配置文件：
此命令会扫描你的项目以查找 LangGraph 代理（例如 createAgent()、StateGraph.compile() 或 workflow.compile() 模式），并生成一个包含所有导出代理的配置文件。示例输出：
只有已导出的代理才会包含在配置中。如果代理未导出，该命令会发出警告，以便你可以添加 export 关键字。

​
3. 安装依赖项

在新的 LangGraph 应用根目录中，以 edit 模式安装依赖项，以便服务器使用你的本地更改：

​
4. 创建 .env 文件

你将在新的 LangGraph 应用根目录中找到一个 .env.example 文件。在新的 LangGraph 应用根目录中创建一个 .env 文件，并将 .env.example 文件的内容复制到其中，填写必要的 API 密钥：

​
5. 启动代理服务器

在本地启动 LangGraph API 服务器：
示例输出：
langgraph dev 命令以内存模式启动代理服务器。此模式适用于开发和测试目的。对于生产用途，请部署具有持久存储后端访问权限的代理服务器。更多信息，请参阅平台设置概述。

​
6. 在 Studio 中测试你的应用程序

Studio 是一个专用的 UI，你可以将其连接到 LangGraph API 服务器，以在本地可视化、交互和调试你的应用程序。通过访问 langgraph dev 命令输出中提供的 URL，在 Studio 中测试你的图：
对于在自定义主机/端口上运行的代理服务器，请更新 URL 中的 baseUrl 查询参数。例如，如果你的服务器运行在 http://myhost:3000：
在你的命令中使用 --tunnel 标志创建一个安全隧道，因为 Safari 在连接到 localhost 服务器时存在限制：

​
7. 测试 API

  1. 安装 LangGraph JS SDK：
  2. 向助手发送消息（无线程运行）：

​
后续步骤

现在你已经在本地运行了一个 LangGraph 应用，可以通过探索部署和高级功能来进一步深入：
将这些文档通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。