Files
langgraph/libs/cli
dependabot[bot] 02f2c2e6c9 chore(deps): bump opentelemetry-api from 1.45.1 to 1.45.2 in /libs/cli (#9695)
Bumps
[opentelemetry-api](https://github.com/open-telemetry/opentelemetry-python)
from 1.45.1 to 1.45.2.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/open-telemetry/opentelemetry-python/releases">opentelemetry-api's
releases</a>.</em></p>
<blockquote>
<h2>Version 1.45.2/0.66b2</h2>
<p>This is a patch release on the previous 1.45.1/0.66b1 release, fixing
the issue(s) below.</p>
<h3>Added</h3>
<ul>
<li><code>opentelemetry-sdk</code>,
<code>opentelemetry-configuration</code>,
<code>opentelemetry-exporter-prometheus</code>: enforce metric
cardinality limits (default 2000) with the
<code>otel.metric.overflow</code> attribute, configurable through
<code>View(aggregation_cardinality_limit=...)</code>, reader
<code>cardinality_limits</code> and declarative configuration (<a
href="https://redirect.github.com/open-telemetry/opentelemetry-python/pull/5809">#5809</a>)</li>
</ul>
<h3>Fixed</h3>
<ul>
<li><code>opentelemetry-api</code>: limit <code>traceparent</code>
header length to 512 characters in
<code>TraceContextTextMapPropagator</code> during extraction (<a
href="https://redirect.github.com/open-telemetry/opentelemetry-python/pull/5818">#5818</a>)</li>
</ul>
</blockquote>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/open-telemetry/opentelemetry-python/blob/main/CHANGELOG.md">opentelemetry-api's
changelog</a>.</em></p>
<blockquote>
<h2>Version 1.45.2/0.66b2 (2026-10-29)</h2>
<h3>Added</h3>
<ul>
<li><code>opentelemetry-sdk</code>,
<code>opentelemetry-configuration</code>,
<code>opentelemetry-exporter-prometheus</code>: enforce metric
cardinality limits
(default 2000) with the <code>otel.metric.overflow</code> attribute,
configurable
through <code>View(aggregation_cardinality_limit=...)</code>, reader
<code>cardinality_limits</code> and declarative configuration
(<a
href="https://redirect.github.com/open-telemetry/opentelemetry-python/pull/5809">#5809</a>)</li>
</ul>
<h3>Fixed</h3>
<ul>
<li><code>opentelemetry-api</code>: limit <code>traceparent</code>
header length to 512 characters in
<code>TraceContextTextMapPropagator</code> during extraction
(<a
href="https://redirect.github.com/open-telemetry/opentelemetry-python/pull/5818">#5818</a>)</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="https://github.com/open-telemetry/opentelemetry-python/commit/ad755945ad69008219e661c33ff1d72ff1bbcb51"><code>ad75594</code></a>
[release/v1.45.x-0.66bx] Prepare release 1.45.2/0.66b2 (<a
href="https://redirect.github.com/open-telemetry/opentelemetry-python/issues/5862">#5862</a>)</li>
<li><a
href="https://github.com/open-telemetry/opentelemetry-python/commit/78123a2755c907c602e02352aebed4be86aa5350"><code>78123a2</code></a>
[release/v1.45.x-0.66bx] Backport metric cardinality limits and
traceparent p...</li>
<li>See full diff in <a
href="https://github.com/open-telemetry/opentelemetry-python/compare/v1.45.1...v1.45.2">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=opentelemetry-api&package-manager=uv&previous-version=1.45.1&new-version=1.45.2)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the
[Security Alerts
page](https://github.com/langchain-ai/langgraph/network/alerts).

</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-11-16 08:59:08 +00:00
..

LangGraph CLI

PyPI - Version PyPI - License PyPI - Downloads Twitter

To help you ship LangGraph apps to production faster, check out LangSmith. LangSmith is a unified developer platform for building, testing, and monitoring LLM applications.

Quick Install

uv add langgraph-cli

🤔 What is this?

The LangGraph CLI is the official command-line interface for LangGraph. It provides tools to create, develop, build, and run LangGraph applications locally or in Docker.

📖 Documentation

For full documentation, see the LangGraph CLI reference. For conceptual guides and tutorials, see the LangGraph Docs.

For development mode with hot reloading:

uv add "langgraph-cli[inmem]"

Commands

langgraph new 🌱

Create a new LangGraph project from a template.

langgraph new [PATH] --template TEMPLATE_NAME

langgraph dev 🏃‍♀️

Run Agent Server in development mode with hot reloading.

langgraph dev [OPTIONS]
  --host TEXT                 Host to bind to (default: 127.0.0.1)
  --port INTEGER             Port to bind to (default: 2024)
  --no-reload               Disable auto-reload
  --debug-port INTEGER      Enable remote debugging
  --no-browser             Skip opening browser window
  -c, --config FILE        Config file path (default: langgraph.json)

langgraph up 🚀

Launch Agent Server in Docker.

langgraph up [OPTIONS]
  -p, --port INTEGER        Port to expose (default: 8123)
  --wait                   Wait for services to start
  --watch                  Restart on file changes
  --verbose               Show detailed logs
  -c, --config FILE       Config file path
  -d, --docker-compose    Additional services file

langgraph build

Build a Docker image for your LangGraph application.

langgraph build -t IMAGE_TAG [OPTIONS]
  --platform TEXT          Target platforms (e.g., linux/amd64,linux/arm64)
  --pull / --no-pull      Use latest/local base image
  -c, --config FILE       Config file path

langgraph dockerfile

Generate a Dockerfile for custom deployments.

langgraph dockerfile SAVE_PATH [OPTIONS]
  -c, --config FILE       Config file path

langgraph deploy

Build and deploy an Agent Server image to LangSmith. Use --agent-server-id to update an existing Agent Server and --agent-server-type to select its type. The legacy --deployment-id and --deployment-type spellings remain supported as hidden compatibility aliases, with no removal scheduled. Older Python CLI versions and the JavaScript CLI may still require the legacy spellings; check command help for your installed version.

Where deploy sends requests

All deploy commands need only a LangSmith API key (LANGSMITH_API_KEY). The CLI asks the LangSmith API (LANGSMITH_ENDPOINT, or https://api.smith.langchain.com by default) which workspaces the key can use. If the workspace runs on a LangSmith data plane in your own cloud (BYOC on AWS, Azure, or GCP), the CLI talks to that data plane's host API and sets the workspace for you. The data plane URL must use https, since the API key is sent there. Status links still point at the LangSmith UI. If the key's workspaces sit on different data planes, set LANGSMITH_TENANT_ID to the workspace ID to reach its data plane; without it, the CLI starts on the LangSmith control plane, and the workspace ID you enter when asked picks the data plane. A LANGSMITH_TENANT_ID the key can't use is an error. If the workspace lookup fails, the CLI says so and uses the LangSmith control plane.

--host-url (or LANGGRAPH_HOST_URL) sends every request to the given host backend URL instead and skips this lookup.

What a data plane supports

On a BYOC data plane, the data plane decides which deployments deploy can make:

  • Building with deploy (a local Docker build, or --remote) needs a data plane that supports CLI builds. Otherwise, push to a registry you manage with --push-to <registry>/<repository>, or deploy an existing image with --image-uri. Both work on every data plane.
  • --agent-server-type defaults to serverless, or to dev on a data plane without scale to zero. Asking for serverless or dedicated on a data plane that doesn't support it fails before anything is created.

langgraph deploy metrics

Fetch Agent Server monitoring time series as JSON. Like the other deploy commands, it finds the API key's workspace and sends the request to that workspace's control plane or data plane (see Where deploy sends requests). Use langgraph deploy list to find the Agent Server ID.

langgraph deploy metrics AGENT_SERVER_ID \
  --start-time 2026-10-28T00:00:00Z \
  --end-time 2026-10-28T01:00:00Z \
  --metrics cpu_usage,memory_usage,worker_count

--metrics accepts a comma-separated list of these names (also listed in langgraph deploy metrics --help):

  • Resource usage: memory_usage, cpu_usage, disk_usage
  • Counts: restart_count, replica_count, worker_count, lg_run_count
  • HTTP traffic: responses_per_second, error_responses_per_second, p95_latency
  • Queue: run_queue_wait_time

These are exact metric names, not free-text search terms. Availability depends on the Agent Server and platform; a supported metric may have no data. Use lg_run_count for Agent Server runs, not the UI schema's placeholder run_count.

Omit --metrics to fetch all available metrics. Time bounds default to the last 15 minutes, and the backend picks the resolution from the time range. This command never prompts; for an organization-scoped key, set LANGSMITH_TENANT_ID to the workspace ID.

Default output is compact JSON grouped by section title, chart title, and series name. Each series contains its real project_metric as metric, inferred unit (percent, count, or null), latest, min, max, avg, and points: [[iso_timestamp, value], ...]. Values are rounded to three decimals; statistics use unrounded finite values and ignore missing samples. latest is the latest non-missing value. Missing samples remain null gaps, and series with no values have null statistics. Empty sections are marked {"_empty":true}.

The top level includes deployment_id, start_time, end_time, and step_seconds. Bounds always describe the requested window, not the observed point bounds. The CLI resolves omitted bounds once: end defaults to now (UTC), and start defaults to 15 minutes before the resolved end. With only --end-time, start is 15 minutes before that value; with only --start-time, end is now. Both values are sent explicitly to the backend and output, even when there are no points. step_seconds is the most common gap between consecutive timestamps within series, with ties broken by the smallest gap. Whole seconds are integers; fractional seconds are preserved. It is null only when every series has fewer than two timestamps. UI metadata and repeated series IDs are omitted. The host-backend response itself is unchanged.

langgraph deploy metrics AGENT_SERVER_ID --summary
langgraph deploy metrics AGENT_SERVER_ID --raw

--summary returns the same shape without points. --raw returns the original UI chart schema without reshaping or rounding. These flags are mutually exclusive. Neither mode returns traces.

Size comparison using the realistic synthetic unit-test fixture (compact JSON serialization for all modes; not a live Agent Server benchmark):

Before: raw UI schema After: default After: summary
4,302 bytes 1,226 bytes (72% smaller) 806 bytes (81% smaller)

Configuration

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

{
  "dependencies": ["langchain_openai", "./your_package"],
  "graphs": {
    "my_graph": "./your_package/file.py:graph"
  },
  "env": "./.env",
  "python_version": "3.11",
  "pip_config_file": "./pip.conf",
  "dockerfile_lines": []
}

Git dependencies should use credential-free URLs. The CLI conservatively scans direct langgraph.json dependencies, common Python package files, uv project and lock files, and common Node.js package and lock files for HTTP Git URLs with userinfo. This check is not exhaustive: generated Docker builds can copy other files, including nested requirement or constraint files, into image layers without scanning them. For private dependencies, provide short-lived credentials through your build environment's secret-backed Git credential helper. Do not store credentials in copied files such as langgraph.json or pip_config_file.

See the full documentation for detailed configuration options.

Development

To develop the CLI itself:

  1. Clone the repository
  2. Navigate to the CLI directory: cd libs/cli
  3. Install development dependencies: uv sync
  4. Make your changes to the CLI code
  5. Test your changes:
# Run CLI commands directly
uv run langgraph --help

# Or use the examples
cd examples
uv sync
uv run langgraph dev  # or other commands

📕 Releases & Versioning

See our Releases and Versioning policies.

💁 Contributing

As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.

For detailed information on how to contribute, see the Contributing Guide.