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.
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
- VS Code: Add this launch configuration:
-
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.
1 maintainer
Release files for langgraph-api 0.14.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| langgraph_api-0.14.1.tar.gz | 811.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| langgraph_api-0.14.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / langgraph_api-0.14.1.tar.gz
| Download URL | langgraph_api-0.14.1.tar.gz |
|---|---|
| Size | 811.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ec024cddd7f74e113fde2d2602a99d839b2af2ae610532f414cd75ab19e620b1
|
|
BLAKE2b-256 checksum How to use checksums |
864b8636d1ae8eeff290b6de26c3e26e00efcba376b91569a4a19827e3104a6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Release files / langgraph_api-0.14.1-py3-none-any.whl
| Download URL | langgraph_api-0.14.1-py3-none-any.whl |
|---|---|
| Size | 622.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7818ee255be91784f786f994d2590e7446a4ec0b3003b9948180e638219832ad
|
|
BLAKE2b-256 checksum How to use checksums |
35efcb0a7258af56144122e82d70e49831c0e8a4ed8a91cc109e28354835e757
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
