---
id: langgraph-cli
version: "0.4.31"
license: MIT
license_treatment: permissive
maintenance: active
---

# langgraph-cli — CLI for interacting with LangGraph API

License: permissive · Maintenance: active · Downloads: 3.5M/mo

## What it is and what it does

LangGraph CLI is the official command-line interface for the LangGraph framework, providing a unified toolkit for the full lifecycle of LangGraph application development. It scaffolds new projects from templates, runs a development server with hot reloading, and packages applications for production deployment via Docker. The CLI reads configuration from a `langgraph.json` file that specifies dependencies, graph entry points, Python version, and custom Dockerfile directives, then orchestrates the build and deployment process.

The tool is designed to accelerate the path from local development to production. Its core commands cover project initialization (`langgraph new`), local development with auto-reload (`langgraph dev`), Docker-based execution (`langgraph up`), image building (`langgraph build`), and Dockerfile generation for custom deployments. It depends on click for CLI parsing, httpx for HTTP operations, langgraph-sdk for API interaction, and standard utilities like python-dotenv and tomli for configuration handling.

Use it for:

- Scaffold a new LangGraph project with a predefined template to start development quickly.
- Run a local development server with hot reloading while iterating on graph logic and dependencies.
- Build and test a LangGraph application in Docker before deploying to production infrastructure.
- Generate a Dockerfile for custom deployment scenarios or integration with existing CI/CD pipelines.
- Configure multi-graph applications with external dependencies and environment variables via langgraph.json.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Command-line interface for creating, developing, building, and deploying LangGraph applications locally or in Docker containers.

Yes. This is the official CLI for LangGraph, actively maintained with no known vulnerabilities, low install friction, and permissive licensing. Install it if you are building or deploying LangGraph applications—it is the standard tool for the job. The only caveat is that Docker-based commands require Docker to be installed separately.

## Install

pip install langgraph-cli
uv add langgraph-cli
poetry add langgraph-cli

## Installing langgraph-cli

Before you install: Low friction installation with a pure-Python wheel and six lightweight runtime dependencies. The project is actively maintained with a recent release and strong community backing (39691 repository stars).

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install langgraph-cli
langgraph new my-project --template default
cd my-project
langgraph dev --port 2024

Requires Python 3.10 or later. Docker is needed for `langgraph up` and `langgraph build` commands.

Verify before relying:

- Whether the `langgraph dev` hot-reload feature works reliably with all dependency types.
- Performance characteristics when building large or complex LangGraph applications.
- Compatibility with non-standard Python environments or package managers beyond uv/pip.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

langgraph cli tool, deploy langgraph apps, langgraph development server, docker build langgraph, langgraph api server, langgraph project scaffolding, langgraph hot reload dev, cli-tool, langgraph-ecosystem, llm-deployment

[View on SkillFed](https://skillfed.io/packages/langgraph-cli) · [View on PyPI](https://pypi.org/project/langgraph-cli/)