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": []
}

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.32.dev0

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.32.dev0
File	Size	Uploaded
langgraph_cli-0.4.32.dev0.tar.gz	1.1 MB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for langgraph-cli 0.4.32.dev0
File	Interpreter	ABI	Platform	Reset
langgraph_cli-0.4.32.dev0-py3-none-any.whl 89.5 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / langgraph_cli-0.4.32.dev0.tar.gz

Download URL	langgraph_cli-0.4.32.dev0.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`829109b803b983ca7c69b68f371a46554654677192695881df9c965ba21f9ab0`
BLAKE2b-256 checksum How to use checksums	`d4d6da5e0e22bda2991f644ccc4cce401583200455169460e0c88837f2968b09`
Upload date	Sep 23, 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.32.dev0-py3-none-any.whl

Download URL	langgraph_cli-0.4.32.dev0-py3-none-any.whl
Size	89.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`30db90c8abab8428f9db7228f5b438f955d3ea04046049d01d5f86a8294ed1a9`
BLAKE2b-256 checksum How to use checksums	`b0664cb004e1a3e7acd0e42f18e595e518bb60f5d492ad12bba2b6286bac3f25`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`