LangGraph CLI

To help you ship LangGraph apps to production faster, check out LangSmith. LangSmith is a unified developer platform for building, testing, and monitoring LLM applications.

Quick Install

uv add langgraph-cli

🤔 What is this?

The LangGraph CLI is the official command-line interface for LangGraph. It provides tools to create, develop, build, and run LangGraph applications locally or in Docker.

📖 Documentation

For full documentation, see the LangGraph CLI reference. For conceptual guides and tutorials, see the LangGraph Docs.

For development mode with hot reloading:

uv add "langgraph-cli[inmem]"

Commands

`langgraph new` 🌱

Create a new LangGraph project from a template.

langgraph new [PATH] --template TEMPLATE_NAME

`langgraph dev` 🏃‍♀️

Run LangGraph API server in development mode with hot reloading.

langgraph dev [OPTIONS]
  --host TEXT                 Host to bind to (default: 127.0.0.1)
  --port INTEGER             Port to bind to (default: 2024)
  --no-reload               Disable auto-reload
  --debug-port INTEGER      Enable remote debugging
  --no-browser             Skip opening browser window
  -c, --config FILE        Config file path (default: langgraph.json)

`langgraph up` 🚀

Launch LangGraph API server in Docker.

langgraph up [OPTIONS]
  -p, --port INTEGER        Port to expose (default: 8123)
  --wait                   Wait for services to start
  --watch                  Restart on file changes
  --verbose               Show detailed logs
  -c, --config FILE       Config file path
  -d, --docker-compose    Additional services file

`langgraph build`

Build a Docker image for your LangGraph application.

langgraph build -t IMAGE_TAG [OPTIONS]
  --platform TEXT          Target platforms (e.g., linux/amd64,linux/arm64)
  --pull / --no-pull      Use latest/local base image
  -c, --config FILE       Config file path

`langgraph dockerfile`

Generate a Dockerfile for custom deployments.

langgraph dockerfile SAVE_PATH [OPTIONS]
  -c, --config FILE       Config file path

Configuration

The CLI uses a langgraph.json configuration file with these key settings:

{
  "dependencies": ["langchain_openai", "./your_package"],
  "graphs": {
    "my_graph": "./your_package/file.py:graph"
  },
  "env": "./.env",
  "python_version": "3.11",
  "pip_config_file": "./pip.conf",
  "dockerfile_lines": []
}

Git dependencies should use credential-free URLs. The CLI conservatively scans direct langgraph.json dependencies, common Python package files, uv project and lock files, and common Node.js package and lock files for HTTP Git URLs with userinfo. This check is not exhaustive: generated Docker builds can copy other files, including nested requirement or constraint files, into image layers without scanning them. For private dependencies, provide short-lived credentials through your build environment's secret-backed Git credential helper. Do not store credentials in copied files such as langgraph.json or pip_config_file.

See the full documentation for detailed configuration options.

Development

To develop the CLI itself:

Clone the repository
Navigate to the CLI directory: cd libs/cli
Install development dependencies: uv sync
Make your changes to the CLI code
Test your changes:

# Run CLI commands directly
uv run langgraph --help

# Or use the examples
cd examples
uv sync
uv run langgraph dev  # or other commands

📕 Releases & Versioning

See our Releases and Versioning policies.

💁 Contributing

As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.

For detailed information on how to contribute, see the Contributing Guide.

Metadata

Release files for langgraph-cli 0.4.33

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for langgraph-cli 0.4.33
File	Size	Uploaded
langgraph_cli-0.4.33.tar.gz	1.1 MB	Oct 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for langgraph-cli 0.4.33
File	Interpreter	ABI	Platform	Reset
langgraph_cli-0.4.33-py3-none-any.whl 91.6 kB Oct 7, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / langgraph_cli-0.4.33.tar.gz

Download URL	langgraph_cli-0.4.33.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`ad11ee1271176a48bf60a20b8356f59b2aac42f7166e5e4a0f040f3aab2186f6`
BLAKE2b-256 checksum How to use checksums	`788c3264f1fb1168681dbe28c08a14dbdd4e0ad404fc881f5e0e63ffc809a3ec`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / langgraph_cli-0.4.33-py3-none-any.whl

Download URL	langgraph_cli-0.4.33-py3-none-any.whl
Size	91.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`09d76c0aed5b661a22760547997038de05f18d7598bb698d921f701831875b41`
BLAKE2b-256 checksum How to use checksums	`24061ffa188545bee9d73bd6df18750894c4351c38d3755dde77e3ea9071b608`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`