langgraph-api 0.6.13__tar.gz

langgraph_api-0.6.13/.gitignore

@@ -0,0 +1,7 @@
+.envrc
+.env_queue
+.env
+.ipynb_checkpoints
+.langgraph-data
+*.sock
+langgraph_api.duckdb*

langgraph_api-0.6.13/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

langgraph_api-0.6.13/Makefile

@@ -0,0 +1,256 @@
+.PHONY: build release lint format test test_watch start start-inmem start-inmem-license-oss start start-js-server build-go-server start-go-server stop-go-server check-version check-base-imports
+
+# Environment variables
+FF_USE_CORE_API ?= false
+LANGSERVE_GRAPHS_ALL = '{"agent": {"path": "./tests/graphs/agent.py:graph", "description": "agent"}, "custom_lifespan": "./tests/graphs/my_router.py:graph", "single_node": "./tests/graphs/single_node.py:graph", "benchmark": "./tests/graphs/benchmark.py:graph", "config_graph": "./tests/graphs/config_graph.py:graph", "other": "./tests/graphs/other.py:make_graph", "weather": "./tests/graphs/weather.py:mk_weather_graph", "searchy": "./tests/graphs/searchy.py:graph", "agent_simple": "./tests/graphs/agent_simple.py:graph", "simple_runtime": "./tests/graphs/simple_runtime.py:graph", "agent_interrupt": "./tests/graphs/agent_interrupt.py:graph", "message_type_test": "./tests/graphs/message_type_test.py:graph", "remote_subgraph_parent": "./tests/graphs/remote_subgraph_parent.py:graph", "simple_remote": "./tests/graphs/simple_remote.py:graph", "nested_subgraphs": "./tests/graphs/nested_subgraphs.py:graph", "functional_fibonacci": "./tests/graphs/functional_fibonacci.py:fibonacci", "state_graph_fibonacci": "./tests/graphs/state_graph_fibonacci.py:fibonacci"}'
+LANGSERVE_GRAPHS_AUTH = '{"agent": {"path": "./tests/graphs/agent.py:graph", "description": "agent"}, "config_graph": "./tests/graphs/config_graph.py:graph", "other": "./tests/graphs/other.py:make_graph", "weather": "./tests/graphs/weather.py:mk_weather_graph", "searchy": "./tests/graphs/searchy.py:graph", "agent_simple": "./tests/graphs/agent_simple.py:graph", "simple_runtime": "./tests/graphs/simple_runtime.py:graph", "functional_fibonacci": "./tests/graphs/functional_fibonacci.py:fibonacci", "state_graph_fibonacci": "./tests/graphs/state_graph_fibonacci.py:fibonacci"}'
+
+# Go server management
+build-go-server:
+	@echo "Building core-server..."
+	$(MAKE) -C ../core build-core-server
+
+start-go-server: # NOTE: core server will start with sqlite if no DATABASE_URI is provided
+	@echo "Starting Core API (SQLite) gRPC server on port 50051..."
+	cd ../core && \
+	FF_USE_CORE_API=true \
+	LANGSERVE_GRAPHS=$(LANGSERVE_GRAPHS_ALL) \
+	DATABASE_URI= \
+	REDIS_URI= \
+	./bin/core-server \
+		-service core-api \
+		-apply-db-schema &
+	@sleep 2
+
+stop-go-server:
+	@echo "Stopping Core API gRPC server on port 50051..."
+	@lsof -ti:50051 | xargs -r kill -9 || echo "No process found on port 50051"
+
+# lint commands
+
+lint:
+	uv run ruff check . --exclude "**/generated/**"
+	uv run ruff format . --diff --exclude "**/generated/**"
+	uv run ty check --exclude "**/pb/**" --exclude "**/*_test.py" --exclude "**/test_*.py" --exclude "**/tests/**" --exclude "venv/**" --exclude ".venv/**" --exclude "build/**" --exclude "dist/**" --exclude "**/generated/**" .
+
+format:
+	uv run ruff check --fix . --exclude "**/generated/**"
+	uv run ruff format . --exclude "**/generated/**"
+
+check-base-imports:
+	LANGGRAPH_RUNTIME_EDITION=inmem DATABASE_URI=:memory: REDIS_URI=_FAKE uv run python -c "from langgraph_api.config import *; from langgraph_runtime import *"
+
+# test commands
+
+TEST ?= tests/ ../runtime_inmem/tests/
+AUTH_TEST ?= "tests/integration_tests/test_custom_auth.py"
+LANGGRAPH_HTTP ?= {"disable_mcp": false, "disable_a2a": false}
+LANGGRAPH_AES_KEY ?= '1234567890123456'
+BG_JOB_TIMEOUT_SECS ?= 3600
+
+ifeq ($(LANGGRAPH_HTTP),fastapi)
+	HTTP_CONFIG := {"app": "./tests/graphs/my_router.py:app", "disable_mcp": false, "disable_a2a": false, "mount_prefix": "/my-cool/api"}
+else
+	HTTP_CONFIG := $(LANGGRAPH_HTTP)
+endif
+
+LANGGRAPH_STORE ?= ""
+ifeq ($(LANGGRAPH_STORE),custom)
+	STORE_CONFIG := {"path": "./tests/graphs/custom_store.py:generate_store"}
+else
+	STORE_CONFIG := {"index": {"dims": 500, "embed": "./tests/graphs/test_utils/embeddings.py:embeddings"}}
+endif
+
+REVISION ?= $(shell git rev-parse --short HEAD)
+LANGGRAPH_ENCRYPTION ?=
+
+test-license-oss:
+	@if [ "$(FF_USE_CORE_API)" = "true" ]; then \
+		LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' LANGGRAPH_STORE='$(STORE_CONFIG)' LANGGRAPH_ENCRYPTION='$(LANGGRAPH_ENCRYPTION)' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ FF_USE_CORE_API=true uv run pytest -m sqlite_grpc -v $(TEST); \
+	else \
+		LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' LANGGRAPH_STORE='$(STORE_CONFIG)' LANGGRAPH_ENCRYPTION='$(LANGGRAPH_ENCRYPTION)' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run pytest -v $(TEST); \
+	fi
+
+test-watch-oss:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' LANGGRAPH_ENCRYPTION='$(LANGGRAPH_ENCRYPTION)' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run --no-sync ptw . -- -x -vv --ff --capture=no $(TEST)
+
+test: test-license-oss
+test-watch: test-watch-oss
+unit-test:
+	DATABASE_URI="test" REDIS_URI="test" uv run pytest tests/unit_tests
+
+test-auth:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_auth.py:get_current_active_user"}' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run pytest -v $(AUTH_TEST)
+
+
+define FASTAPI_JWT_AUTH_TEST
+	LANGGRAPH_RUNTIME_EDITION=inmem \
+	LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_middleware_ordering.py:auth"}' \
+	REDIS_URI=_FAKE \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem__ \
+	LANGGRAPH_HTTP='{"app": "./tests/graphs/fastapi_jwt_middleware_ordering.py:app", "middleware_order": "$(1)", "enable_custom_route_auth": $(2)}' \
+	uv run pytest -v $(AUTH_TEST)
+endef
+
+test-auth-fastapi-jwt--before-custom-middleware--no-custom-route-auth:
+	$(call FASTAPI_JWT_AUTH_TEST,auth_first,false)
+
+test-auth-fastapi-jwt--after-custom-middleware--no-custom-route-auth:
+	$(call FASTAPI_JWT_AUTH_TEST,middleware_first,false)
+
+test-auth-fastapi-jwt--before-custom-middleware--custom-route-auth:
+	$(call FASTAPI_JWT_AUTH_TEST,auth_first,true)
+
+test-auth-fastapi-jwt--after-custom-middleware--custom-route-auth:
+	$(call FASTAPI_JWT_AUTH_TEST,middleware_first, true)
+
+
+test-auth-watch:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_auth.py:get_current_active_user"}' REDIS_URI=_FAKE DATABASE_URI=:memory: MIGRATIONS_PATH=__inmem__ uv run ptw . -- -x -vv --ff --capture=no $(AUTH_TEST)
+
+# dev commands
+
+start:
+	@if [ "$(FF_USE_CORE_API)" = "true" ]; then \
+		$(MAKE) build-go-server && $(MAKE) start-go-server; \
+		trap '$(MAKE) stop-go-server' INT TERM EXIT; \
+	fi; \
+	sleep 3 && \
+	LANGGRAPH_HTTP='$(HTTP_CONFIG)' \
+	LANGGRAPH_RUNTIME_EDITION=inmem \
+	LANGGRAPH_AES_KEY='$(LANGGRAPH_AES_KEY)' \
+	N_JOBS_PER_WORKER=2 \
+	LANGSERVE_GRAPHS=$(LANGSERVE_GRAPHS_ALL) \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_CONFIG='{"agent": {"configurable": {"model_name": "openai"}}}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	FF_USE_CORE_API=$(FF_USE_CORE_API) \
+	BG_JOB_TIMEOUT_SECS=$(BG_JOB_TIMEOUT_SECS) \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--reload-dir ../runtime_inmem \
+		--no-access-log
+
+
+start-license-oss: start
+
+start-encrypt:
+	LANGGRAPH_HTTP='$(HTTP_CONFIG)' \
+	LANGGRAPH_RUNTIME_EDITION=inmem \
+	LANGGRAPH_AES_KEY='$(LANGGRAPH_AES_KEY)' \
+	N_JOBS_PER_WORKER=2 \
+	LANGSERVE_GRAPHS=$(LANGSERVE_GRAPHS_ALL) \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_ENCRYPTION='{"path": "./tests/graphs/custom_encryption.py:encryption"}' \
+	LANGGRAPH_CONFIG='{"agent": {"configurable": {"model_name": "openai"}}}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	BG_JOB_TIMEOUT_SECS=$(BG_JOB_TIMEOUT_SECS) \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--reload-dir ../runtime_inmem \
+		--no-access-log
+
+
+start-auth-jwt:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' \
+	LANGGRAPH_AES_KEY='$(LANGGRAPH_AES_KEY)' \
+	N_JOBS_PER_WORKER=2 \
+	LANGSERVE_GRAPHS=$(LANGSERVE_GRAPHS_AUTH) \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_AUTH='{"path": "tests/graphs/jwt_auth.py:auth"}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--reload-dir ../runtime_inmem \
+		--no-access-log
+
+start-auth-fastapi-jwt:
+	LANGGRAPH_RUNTIME_EDITION=inmem LANGGRAPH_HTTP='$(HTTP_CONFIG)' \
+	N_JOBS_PER_WORKER=2 \
+	LANGSERVE_GRAPHS=$(LANGSERVE_GRAPHS_AUTH) \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_auth.py:auth"}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--reload-dir ../runtime_inmem \
+		--no-access-log
+
+define RUN_FASTAPI_JWT_MW_ORDERING
+	LANGGRAPH_RUNTIME_EDITION=inmem \
+	LANGGRAPH_HTTP='{"app": "./tests/graphs/fastapi_jwt_middleware_ordering.py:app", "middleware_order": "$(1)", "enable_custom_route_auth": $(2)}' \
+	N_JOBS_PER_WORKER=2 \
+	LANGSERVE_GRAPHS=$(LANGSERVE_GRAPHS_AUTH) \
+	LANGGRAPH_STORE='$(STORE_CONFIG)' \
+	LANGGRAPH_AUTH='{"path": "./tests/graphs/fastapi_jwt_middleware_ordering.py:auth"}' \
+	LANGSMITH_LANGGRAPH_API_VARIANT=test \
+	REDIS_URI=fake \
+	DATABASE_URI=:memory: \
+	MIGRATIONS_PATH=__inmem \
+	uv run uvicorn \
+		"langgraph_api.server:app" \
+		--reload \
+		--port 9123 \
+		--reload-dir langgraph_api \
+		--reload-dir ../runtime_inmem \
+		--no-access-log
+endef
+
+start-auth-fastapi-jwt--before-custom-middleware--no-custom-route-auth:
+	$(call RUN_FASTAPI_JWT_MW_ORDERING,auth_first,false)
+
+start-auth-fastapi-jwt--after-custom-middleware--no-custom-route-auth:
+	$(call RUN_FASTAPI_JWT_MW_ORDERING,middleware_first,false)
+
+start-auth-fastapi-jwt--before-custom-middleware--custom-route-auth:
+	$(call RUN_FASTAPI_JWT_MW_ORDERING,auth_first,true)
+
+start-auth-fastapi-jwt--after-custom-middleware--custom-route-auth:
+	$(call RUN_FASTAPI_JWT_MW_ORDERING,middleware_first,true)
+
+
+start-js-server:
+	@echo "Building and starting Go gRPC server..."
+	$(MAKE) build-go-server
+	$(MAKE) start-go-server
+	@trap '$(MAKE) -C $(CURDIR) stop-go-server' INT TERM EXIT; \
+	echo "Installing JS server dependencies..."; \
+	cd ../public-api-server-js && yarn install; \
+	echo "Building JS server..."; \
+	cd ../public-api-server-js && yarn run build; \
+	echo "Starting JS server on port 9123..."; \
+	cd ../public-api-server-js && FF_USE_CORE_API=true \
+	LANGSERVE_GRAPHS=$(LANGSERVE_GRAPHS_ALL) \
+	LANGGRAPH_CONFIG='{"agent": {"configurable": {"model_name": "openai"}}}' \
+	FF_USE_JS_API=true \
+	PORT=9123 yarn start
+
+VERSION_KIND ?= patch
+
+bump-version:
+	uv run --with hatch hatch version $(VERSION_KIND)

langgraph_api-0.6.13/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: langgraph-api
+Version: 0.6.13
+Author-email: Will Fu-Hinthorn <will@langchain.dev>, Josh Rogers <josh@langchain.dev>, Parker Rule <parker@langchain.dev>
+License: Elastic-2.0
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: cloudpickle>=3.0.0
+Requires-Dist: cryptography<47.0,>=42.0.0
+Requires-Dist: grpcio-tools==1.75.1
+Requires-Dist: grpcio<2.0.0,>=1.75.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: jsonschema-rs<0.30,>=0.20.0
+Requires-Dist: langchain-core>=0.3.64
+Requires-Dist: langgraph-checkpoint<5,>=3.0.1
+Requires-Dist: langgraph-runtime-inmem<0.21.0,>=0.20.0
+Requires-Dist: langgraph-sdk>=0.3.0
+Requires-Dist: langgraph<2,>=0.4.10
+Requires-Dist: langsmith>=0.3.45
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: orjson>=3.9.7
+Requires-Dist: protobuf<7.0.0,>=6.32.1
+Requires-Dist: pyjwt>=2.9.0
+Requires-Dist: sse-starlette<2.2.0,>=2.1.0
+Requires-Dist: starlette>=0.38.6
+Requires-Dist: structlog<26,>=24.1.0
+Requires-Dist: tenacity>=8.0.0
+Requires-Dist: truststore>=0.1
+Requires-Dist: uuid-utils>=0.12.0
+Requires-Dist: uvicorn>=0.26.0
+Requires-Dist: watchfiles>=0.13
+Description-Content-Type: text/markdown
+
+# 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](https://langchain-ai.github.io/langgraph/concepts/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`.
+
+```bash
+pip install -U langgraph-cli[inmem]
+```
+
+## Quickstart
+
+1. (Optional) Clone a starter template:
+
+   ```bash
+   langgraph new --template new-langgraph-project-python ./my-project
+   cd my-project
+   ```
+
+   (Recommended) Use a virtual environment and install dependencies:
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate
+   python -m pip install .
+   ```
+
+2. Start the development server:
+
+   ```shell
+   langgraph dev --config ./langgraph.json
+   ```
+
+3. 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:
+
+```bash
+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.
+
+1. Install debugpy:
+
+   ```bash
+   pip install debugpy
+   ```
+
+2. Start the server in debug mode:
+
+   ```bash
+   langgraph dev --debug-port 5678
+   ```
+
+3. Configure your IDE:
+
+   - **VS Code**: Add this launch configuration:
+     ```json
+     {
+       "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
+
+4. Set breakpoints in your graph code and start debugging.
+
+## CLI options
+
+```bash
+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](./LICENSE) file for details.

langgraph_api-0.6.13/README.md

@@ -0,0 +1,101 @@
+# 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](https://langchain-ai.github.io/langgraph/concepts/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`.
+
+```bash
+pip install -U langgraph-cli[inmem]
+```
+
+## Quickstart
+
+1. (Optional) Clone a starter template:
+
+   ```bash
+   langgraph new --template new-langgraph-project-python ./my-project
+   cd my-project
+   ```
+
+   (Recommended) Use a virtual environment and install dependencies:
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate
+   python -m pip install .
+   ```
+
+2. Start the development server:
+
+   ```shell
+   langgraph dev --config ./langgraph.json
+   ```
+
+3. 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:
+
+```bash
+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.
+
+1. Install debugpy:
+
+   ```bash
+   pip install debugpy
+   ```
+
+2. Start the server in debug mode:
+
+   ```bash
+   langgraph dev --debug-port 5678
+   ```
+
+3. Configure your IDE:
+
+   - **VS Code**: Add this launch configuration:
+     ```json
+     {
+       "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
+
+4. Set breakpoints in your graph code and start debugging.
+
+## CLI options
+
+```bash
+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](./LICENSE) file for details.

langgraph_api-0.6.13/benchmark/.gitignore

@@ -0,0 +1,10 @@
+# K6 summary and results files
+results_*.json
+summary_*.json
+raw_data_*.json
+
+# Generated chart files
+*_chart_*.png
+
+# Node.js dependencies
+node_modules/

langgraph_api-0.6.13/benchmark/Makefile

@@ -0,0 +1,89 @@
+# Benchmark commands
+BASE_URL ?= https://benchmark-dr-s-2799835ad04b501a95044223ae72ced7.staging.langgraph.app
+SLOWEST_N ?= 2
+RAMP_START ?= 40
+RAMP_END ?= 1000
+RAMP_MULTIPLIER ?= 2
+WAIT_SECONDS ?= 60
+CLEAR_BETWEEN_STEPS ?= true
+CLEAR_DELAY_SECONDS ?= 5
+DATA_SIZE ?= 1000
+DELAY ?= 0
+EXPAND ?= 1
+STEPS ?= 100
+
+benchmark-burst:
+	make benchmark-reset
+	k6 run burst.js
+
+benchmark-ramp:
+	make benchmark-reset
+	k6 run --out json=raw_data_$(shell date +%Y-%m-%dT%H-%M-%S).json --system-tags=[] ramp.js
+
+benchmark-capacity:
+	rm -f capacity_summary_t*.json capacity_raw_t*.json capacity_histogram_*.json
+	npm install
+	BASE_URL=$(BASE_URL) \
+	SLOWEST_N=$(SLOWEST_N) \
+	RAMP_START=$(RAMP_START) \
+	RAMP_END=$(RAMP_END) \
+	RAMP_MULTIPLIER=$(RAMP_MULTIPLIER) \
+	WAIT_SECONDS=$(WAIT_SECONDS) \
+	CLEAR_BETWEEN_STEPS=$(CLEAR_BETWEEN_STEPS) \
+	CLEAR_DELAY_SECONDS=$(CLEAR_DELAY_SECONDS) \
+	DATA_SIZE=$(DATA_SIZE) \
+	DELAY=$(DELAY) \
+	EXPAND=$(EXPAND) \
+	STEPS=$(STEPS) \
+	node capacity_runner.mjs
+
+benchmark-charts:
+	npm install
+	node graphs.js $(shell ls -t raw_data_*.json | head -1) true
+
+benchmark-reset:
+	node clean.js
+
+benchmark-new-revision:
+	node update-revision.js
+
+benchmark-clean:
+	rm -f results_*.json summary_*.json raw_data_*.json *_chart_*.png
+
+benchmark-clean-charts:
+	rm -f *_chart_*.png
+
+# Mixed workload benchmark - tests quick runs competing with long runs
+QUICK_VUS ?= 250
+QUICK_ITERATIONS ?= 1000
+QUICK_STEPS ?= 5
+QUICK_DATA_SIZE ?= 100
+QUICK_MAX_WAIT_SECONDS ?= 120
+QUICK_POLL_INTERVAL ?= 2
+LONG_VUS ?= 5
+LONG_ITERATIONS ?= 10
+LONG_STEPS ?= 50
+LONG_DELAY ?= 1
+LONG_DATA_SIZE ?= 10000
+LONG_MAX_WAIT_SECONDS ?= 200
+LONG_POLL_INTERVAL ?= 5
+
+benchmark-mixed:
+	rm -f mixed_workload_*.json
+	npm install
+	BASE_URL=$(BASE_URL) \
+	SLOWEST_N=$(SLOWEST_N) \
+	QUICK_VUS=$(QUICK_VUS) \
+	QUICK_ITERATIONS=$(QUICK_ITERATIONS) \
+	QUICK_STEPS=$(QUICK_STEPS) \
+	QUICK_DATA_SIZE=$(QUICK_DATA_SIZE) \
+	QUICK_MAX_WAIT_SECONDS=$(QUICK_MAX_WAIT_SECONDS) \
+	QUICK_POLL_INTERVAL=$(QUICK_POLL_INTERVAL) \
+	LONG_VUS=$(LONG_VUS) \
+	LONG_ITERATIONS=$(LONG_ITERATIONS) \
+	LONG_STEPS=$(LONG_STEPS) \
+	LONG_DELAY=$(LONG_DELAY) \
+	LONG_DATA_SIZE=$(LONG_DATA_SIZE) \
+	LONG_MAX_WAIT_SECONDS=$(LONG_MAX_WAIT_SECONDS) \
+	LONG_POLL_INTERVAL=$(LONG_POLL_INTERVAL) \
+	node mixed_workload_runner.mjs