LangGraph.js CLI

The official command-line interface for LangGraph.js, providing tools to create, develop, and deploy LangGraph.js applications.

Installation

The @langchain/langgraph-cli is a CLI binary that can be run via npx or installed via your package manager of choice:

npx @langchain/langgraph-cli
Copy

Commands

langgraphjs dev

Run LangGraph.js API server in development mode with hot reloading.

npx @langchain/langgraph-cli dev
Copy

langgraphjs build

Build a Docker image for your LangGraph.js application.

npx @langchain/langgraph-cli build
Copy

langgraphjs up

Run LangGraph.js API server in Docker.

npx @langchain/langgraph-cli up
Copy

langgraphjs dockerfile

Generate a Dockerfile for custom deployments

npx @langchain/langgraph-cli dockerfile <save path>
Copy

Configuration

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

{
  // Required: Graph definitions
  graphs: {
    graph: "./src/graph.ts:graph",
  },

  // Optional: Node version (20 only at the moment)
  node_version: "20",

  // Optional: Environment variables
  env: ".env",

  // Optional: Additional Dockerfile commands
  dockerfile_lines: [],
}
Copy

See the full documentation for detailed configuration options.