LangGraph API

This package implements the LangGraph API for rapid development and testing. Build and iterate on LangGraph agents with a tight feedback loop. The server is backed by a predominently in-memory data store that is persisted to local disk when the server is restarted.

For production use, see the various deployment options for the LangGraph API, which are backed by a production-grade database.

Installation

Install the langgraph-cli package with the inmem extra. Your CLI version must be no lower than 0.1.55.

pip install -U "langgraph-cli[inmem]"

Quickstart

(Optional) Clone a starter template:

langgraph new --template new-langgraph-project-python ./my-project
cd my-project

(Recommended) Use a virtual environment and install dependencies:

python -m venv .venv
source .venv/bin/activate
python -m pip install .

Start the development server:

langgraph dev --config ./langgraph.json

The server will launch, opening a browser window with the graph UI. Interact with your graph or make code edits; the server automatically reloads on changes.

Usage

Start the development server:

langgraph dev

Your agent's state (threads, runs, assistants) persists in memory while the server is running - perfect for development and testing. Each run's state is tracked and can be inspected, making it easy to debug and improve your agent's behavior.

A2A task history scope

An A2A context can contain multiple tasks. By default, SendMessage, GetTask, and ListTasks return the full context history. Set historyScope to task to return only messages that belong to the requested task.

For SendMessage, set it in configuration:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "parts": [{"text": "Second request"}],
      "messageId": "message-2",
      "contextId": "8b1f0e5c-9a3d-4f27-b0c8-2e6a5d4c1b7a"
    },
    "configuration": {"historyScope": "task"}
  }
}

For GetTask and ListTasks, set it directly in params. If changing the request body is not possible, send LangGraph-A2A-History-Scope: task instead. An explicit request value takes precedence over the header.

{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "GetTask",
  "params": {"id": "<taskId>", "historyScope": "task"}
}

{
  "jsonrpc": "2.0",
  "id": "3",
  "method": "ListTasks",
  "params": {"contextId": "<contextId>", "historyScope": "task"}
}

The agent card advertises support through the https://langchain.com/a2a/extensions/history-scope/v1 extension.

How-To

Attaching a debugger

Debug mode lets you attach your IDE's debugger to the LangGraph API server to set breakpoints and step through your code line-by-line.

Install debugpy:
```
pip install debugpy
```
Start the server in debug mode:
```
langgraph dev --debug-port 5678
```

Configure your IDE:

VS Code: Add this launch configuration:

{
  "name": "Attach to LangGraph",
  "type": "debugpy",
  "request": "attach",
  "connect": {
           "host": "0.0.0.0",
           "port": 5678
       },
}

PyCharm: Use "Attach to Process" and select the langgraph process

Set breakpoints in your graph code and start debugging.

CLI options

langgraph dev [OPTIONS]
Options:
  --debug-port INTEGER         Enable remote debugging on specified port
  --no-browser                 Skip opening browser on startup
  --n-jobs-per-worker INTEGER  Maximum concurrent jobs per worker process
  --config PATH               Custom configuration file path
  --no-reload                 Disable code hot reloading
  --port INTEGER              HTTP server port (default: 8000)
  --host TEXT                 HTTP server host (default: localhost)

License

This project is licensed under the Elastic License 2.0 - see the LICENSE file for details.

Release files for langgraph-api 0.16.0rc1

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-api 0.16.0rc1
File	Size	Uploaded
langgraph_api-0.16.0rc1.tar.gz	871.0 kB	Sep 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for langgraph-api 0.16.0rc1
File	Interpreter	ABI	Platform	Reset
langgraph_api-0.16.0rc1-py3-none-any.whl 648.8 kB Sep 25, 2026	Python 3	none	any	Details

Total release size: 1.5 MB

Release files / langgraph_api-0.16.0rc1.tar.gz

Download URL	langgraph_api-0.16.0rc1.tar.gz
Size	871.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`ee6a5107e203bc98e39f1fbbb03a48df71f1cd4354549f0ae40336440946cbf3`
BLAKE2b-256 checksum How to use checksums	`5893008c9d520347019938dd20039808914a528bf343acb4b80f9089a62cb4bb`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Release files / langgraph_api-0.16.0rc1-py3-none-any.whl

Download URL	langgraph_api-0.16.0rc1-py3-none-any.whl
Size	648.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7342ae276b15b2244f9937adf04474b6077246da8b74d78fc81066dd0a9fac36`
BLAKE2b-256 checksum How to use checksums	`496d670089eabd62af95db23efcbdf67b733a1ee46a20f381527bfc023ff1b69`
Upload date	Sep 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`