{"id":2095,"library":"langgraph-cli","title":"LangGraph CLI","description":"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.","status":"active","version":"0.4.21","language":"en","source_language":"en","source_url":"https://github.com/langchain-ai/langgraph/tree/main/libs/cli","tags":["cli","langgraph","llm","orchestration","deployment","langchain"],"install":[{"cmd":"pip install langgraph-cli","lang":"bash","label":"Install LangGraph CLI"}],"dependencies":[],"imports":[],"quickstart":{"code":"langgraph --help","lang":"bash","description":"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."},"warnings":[{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions with deploy functionality"},{"fix":"Always consult the `langgraph <command> --help` output or the official documentation for the specific version you are using, especially after updating the CLI.","message":"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.","severity":"breaking","affected_versions":"Prior to 0.4.21, and potentially in future minor releases."},{"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='...'`.","message":"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`.","severity":"gotcha","affected_versions":"All versions interacting with remote endpoints."}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}