LangGraph CLI

0.4.21 · active · verified Thu Apr 09

The `langgraph-cli` is a command-line interface tool designed to interact with the LangGraph API, primarily for deploying, managing, and running LangGraph applications. It enables developers to build, deploy, and validate LangGraph applications to various environments. The current version is 0.4.21, and it's actively developed with frequent releases, often alongside updates to the core `langgraph` library.

Warnings

gotcha The `langgraph-cli` is distinct from the `langgraph` Python library. The CLI is used for deploying and interacting with *deployed* LangGraph applications, not for authoring or running local Python `langgraph` code directly. Users often confuse the two.
Fix: Understand that the CLI operates on deployed services. For local development, use the `langgraph` Python package. For interacting with remote deployments, use the CLI.
gotcha Deploying LangGraph applications with `langgraph deploy` often requires external dependencies like Docker or specific cloud provider credentials (e.g., for AWS ECS/Lambda, GCP Cloud Run). The CLI itself doesn't bundle these dependencies.
Fix: Ensure your environment is set up with Docker and relevant cloud SDKs/credentials before attempting `langgraph deploy` commands. Refer to the official LangGraph documentation for deployment prerequisites.
breaking CLI command arguments and subcommands can change between minor versions. For instance, the `deploy` subcommands, or available flags, may be modified or renamed. New commands like `validate` are added incrementally.
Fix: Always consult the `langgraph <command> --help` output or the official documentation for the specific version you are using, especially after updating the CLI.
gotcha When interacting with remote LangGraph applications (e.g., using `langgraph run`), you need to configure access via environment variables like `LANGCHAIN_API_KEY` and `LANGCHAIN_ENDPOINT`.
Fix: Set `LANGCHAIN_API_KEY` and `LANGCHAIN_ENDPOINT` environment variables in your shell before running commands that interact with remote LangGraph deployments. Example: `export LANGCHAIN_API_KEY='...'`.

Install

pip install langgraph-cli Install LangGraph CLI

Quickstart

The `langgraph-cli` is a command-line utility, so it's not imported in Python code. This quickstart demonstrates how to check its installation and view available commands.

langgraph --help

view raw JSON →