Skip to content

LangGraph CLI

先决条件

LangGraph CLI 是一个多平台命令行工具，用于在本地构建和运行 LangGraph API 服务器。这为在所有主要操作系统（Linux、Windows、MacOS）上开发和测试代理提供了一个替代方案，替代 LangGraph Studio 电脑版。生成的服务器包含您图形运行、线程、助手等的所有 API 端点，以及运行您的代理所需的其他服务，包括用于检查点和存储的管理数据库。

安装

可以通过 Homebrew（在 macOS 上）或 pip 安装 LangGraph CLI：

brew install langgraph-cli

pip install langgraph-cli

命令

CLI 提供以下核心功能：

build

langgraph build 命令构建一个可直接部署的 LangGraph API 服务器 的 Docker 镜像。

dev

版本 0.1.55 新增

langgraph dev 命令在 langgraph-cli 版本 0.1.55 中引入。

仅限 Python

目前，CLI 仅支持 Python >= 3.11。 JS 支持即将推出。

langgraph dev 命令启动一个轻量级的开发服务器，且无需 Docker 安装。这个服务器非常适合快速开发和测试，具备以下功能：

  • 热重载：对代码的更改会自动检测并重载
  • 调试支持：连接 IDE 的调试器进行逐行调试
  • 具有本地持久性的内存状态：服务器状态存储在内存中以加快速度，但在重启之间保持本地持久性

要使用此命令，您需要安装带有 "inmem" 附加功能的 CLI：

pip install -U "langgraph-cli[inmem]"

注意：此命令仅用于本地开发和测试，不建议在生产环境中使用。由于不使用 Docker，我们建议使用虚拟环境来管理项目的依赖关系。

up

langgraph up 命令在本地的 Docker 容器中启动一个 LangGraph API 服务器 的实例。这需要本地运行 Docker 服务器。此外，它需要 LangSmith API 密钥用于本地开发，或用于生产使用的许可证密钥。

该服务器包含您图形运行、线程、助手等的所有 API 端点，以及运行您的代理所需的其他服务，包括用于检查点和存储的管理数据库。

dockerfile

langgraph dockerfile 命令生成一个 Dockerfile，可用于构建图像和部署 LangGraph API 服务器 的实例。如果您想进一步自定义 Dockerfile 或以更自定义的方式进行部署，这非常有用。

相关