From 8558481859c7951776954401841ce18609cdd1cc Mon Sep 17 00:00:00 2001 From: Mason Daugherty Date: Fri, 12 Jun 2026 19:32:10 -0400 Subject: [PATCH] docs: standardize package `README.md` structure (#8064) Aligns the repository's package READMEs around a shared documentation shape so users see consistent install, positioning, docs, release, and contribution guidance across LangGraph packages. --- examples/README.md | 10 ++- libs/checkpoint-conformance/README.md | 32 ++++++-- libs/checkpoint-postgres/README.md | 36 ++++++++- libs/checkpoint-sqlite/README.md | 32 +++++++- libs/checkpoint/README.md | 34 ++++++++- libs/cli/README.md | 89 ++++++++++++++-------- libs/cli/js-examples/README.md | 6 +- libs/langgraph/README.md | 103 ++++++-------------------- libs/prebuilt/README.md | 44 +++++++++-- libs/sdk-js/README.md | 12 ++- libs/sdk-py/README.md | 39 +++++++--- 11 files changed, 299 insertions(+), 138 deletions(-) diff --git a/examples/README.md b/examples/README.md index 45dcc79c2..daabd089d 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,3 +1,11 @@ # LangGraph examples -This directory is retained purely for archival purposes and is no longer updated. The examples previously found here have been moved to the newly [consolidated LangChain documentation](https://docs.langchain.com/oss/python/langgraph/overview). Please refer to the LangChain docs for the most up-to-date examples and usage guidelines for LangGraph. +This directory is retained purely for archival purposes and is no longer updated. + +## πŸ€” What is this? + +The examples previously found here have been moved to the consolidated LangChain documentation. This directory remains available for historical reference, but new examples and usage guidance are published in the docs. + +## πŸ“– Documentation + +For up-to-date LangGraph examples, tutorials, and guides, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). Get started with the [LangGraph Quickstart](https://docs.langchain.com/oss/python/langgraph/quickstart). diff --git a/libs/checkpoint-conformance/README.md b/libs/checkpoint-conformance/README.md index cc26a2ede..e8a8a8a79 100644 --- a/libs/checkpoint-conformance/README.md +++ b/libs/checkpoint-conformance/README.md @@ -1,15 +1,27 @@ -# langgraph-checkpoint-conformance +# LangGraph Checkpoint Conformance -Conformance test suite for [LangGraph](https://github.com/langchain-ai/langgraph) checkpointer implementations. +[![PyPI - Version](https://img.shields.io/pypi/v/langgraph-checkpoint-conformance?label=%20)](https://pypi.org/project/langgraph-checkpoint-conformance/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph-checkpoint-conformance)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph-checkpoint-conformance)](https://pypistats.org/packages/langgraph-checkpoint-conformance) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) -Validates that a `BaseCheckpointSaver` subclass correctly implements the checkpoint storage contract β€” blob round-trips, metadata preservation, namespace isolation, incremental channel updates, and more. +To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. -## Installation +## Quick Install ```bash -pip install langgraph-checkpoint-conformance +uv add langgraph-checkpoint-conformance ``` +## πŸ€” What is this? + +This library provides a conformance test suite for [LangGraph](https://github.com/langchain-ai/langgraph) checkpointer implementations. It validates that a `BaseCheckpointSaver` subclass correctly implements the checkpoint storage contract β€” blob round-trips, metadata preservation, namespace isolation, incremental channel updates, and more. + +## πŸ“– Documentation + +For full documentation, see the [API reference](https://reference.langchain.com/python/langgraph/). For conceptual guides on persistence and memory, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). + ## Quick start Register your checkpointer with `@checkpointer_test` and run `validate()`: @@ -110,3 +122,13 @@ async def pg_checkpointer(): async with PostgresSaver.from_conn_string(CONN_STRING) as saver: yield saver ``` + +## πŸ“• Releases & Versioning + +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/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](https://docs.langchain.com/oss/python/contributing/overview). diff --git a/libs/checkpoint-postgres/README.md b/libs/checkpoint-postgres/README.md index 320ecf839..f3ccc0da2 100644 --- a/libs/checkpoint-postgres/README.md +++ b/libs/checkpoint-postgres/README.md @@ -1,10 +1,28 @@ # LangGraph Checkpoint Postgres -Implementation of LangGraph CheckpointSaver that uses Postgres. +[![PyPI - Version](https://img.shields.io/pypi/v/langgraph-checkpoint-postgres?label=%20)](https://pypi.org/project/langgraph-checkpoint-postgres/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph-checkpoint-postgres)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph-checkpoint-postgres)](https://pypistats.org/packages/langgraph-checkpoint-postgres) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) -## Dependencies +To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. -By default `langgraph-checkpoint-postgres` installs `psycopg` (Psycopg 3) without any extras. However, you can choose a specific installation that best suits your needs [here](https://www.psycopg.org/psycopg3/docs/basic/install.html) (for example, `psycopg[binary]`). +## Quick Install + +```bash +uv add langgraph-checkpoint-postgres +``` + +## πŸ€” What is this? + +This library provides a Postgres implementation of LangGraph's checkpoint saver. Use it when you want LangGraph state persistence backed by Postgres for durable, long-running workflows and agents. + +By default, `langgraph-checkpoint-postgres` installs `psycopg` (Psycopg 3) without any extras. You can choose a specific installation that best suits your needs in the [Psycopg installation docs](https://www.psycopg.org/psycopg3/docs/basic/install.html), for example `psycopg[binary]`. + +## πŸ“– Documentation + +For full documentation, see the [API reference](https://reference.langchain.com/python/langgraph.checkpoint.postgres). For conceptual guides on persistence and memory, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). ## Security @@ -20,10 +38,12 @@ By default `langgraph-checkpoint-postgres` installs `psycopg` (Psycopg 3) withou > When manually creating Postgres connections and passing them to `PostgresSaver` or `AsyncPostgresSaver`, make sure to include `autocommit=True` and `row_factory=dict_row` (`from psycopg.rows import dict_row`). See a full example in this [how-to guide](https://langchain-ai.github.io/langgraph/how-tos/persistence_postgres/). > > **Why these parameters are required:** +> > - `autocommit=True`: Required for the `.setup()` method to properly commit the checkpoint tables to the database. Without this, table creation may not be persisted. > - `row_factory=dict_row`: Required because the PostgresSaver implementation accesses database rows using dictionary-style syntax (e.g., `row["column_name"]`). The default `tuple_row` factory returns tuples that only support index-based access (e.g., `row[0]`), which will cause `TypeError` exceptions when the checkpointer tries to access columns by name. > > **Example of incorrect usage:** +> > ```python > # ❌ This will fail with TypeError during checkpointer operations > with psycopg.connect(DB_URI) as conn: # Missing autocommit=True and row_factory=dict_row @@ -118,3 +138,13 @@ async with AsyncPostgresSaver.from_conn_string(DB_URI) as checkpointer: # list checkpoints [c async for c in checkpointer.alist(read_config)] ``` + +## πŸ“• Releases & Versioning + +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/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](https://docs.langchain.com/oss/python/contributing/overview). diff --git a/libs/checkpoint-sqlite/README.md b/libs/checkpoint-sqlite/README.md index f38f0c311..16ff9dc3c 100644 --- a/libs/checkpoint-sqlite/README.md +++ b/libs/checkpoint-sqlite/README.md @@ -1,6 +1,26 @@ # LangGraph SQLite Checkpoint -Implementation of LangGraph CheckpointSaver that uses SQLite DB (both sync and async, via `aiosqlite`) +[![PyPI - Version](https://img.shields.io/pypi/v/langgraph-checkpoint-sqlite?label=%20)](https://pypi.org/project/langgraph-checkpoint-sqlite/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph-checkpoint-sqlite)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph-checkpoint-sqlite)](https://pypistats.org/packages/langgraph-checkpoint-sqlite) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) + +To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. + +## Quick Install + +```bash +uv add langgraph-checkpoint-sqlite +``` + +## πŸ€” What is this? + +This library provides a SQLite implementation of LangGraph's checkpoint saver, with both sync and async support via `aiosqlite`. Use it when you want LangGraph state persistence backed by SQLite for local development, testing, or lightweight deployments. + +## πŸ“– Documentation + +For full documentation, see the [API reference](https://reference.langchain.com/python/langgraph.checkpoint.sqlite). For conceptual guides on persistence and memory, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). ## Security @@ -91,3 +111,13 @@ async with AsyncSqliteSaver.from_conn_string(":memory:") as checkpointer: # list checkpoints [c async for c in checkpointer.alist(read_config)] ``` + +## πŸ“• Releases & Versioning + +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/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](https://docs.langchain.com/oss/python/contributing/overview). diff --git a/libs/checkpoint/README.md b/libs/checkpoint/README.md index 3bfcbccaf..a9eb928f6 100644 --- a/libs/checkpoint/README.md +++ b/libs/checkpoint/README.md @@ -1,6 +1,26 @@ # LangGraph Checkpoint -This library defines the base interface for LangGraph checkpointers. Checkpointers provide a persistence layer for LangGraph. They allow you to interact with and manage the graph's state. When you use a graph with a checkpointer, the checkpointer saves a _checkpoint_ of the graph state at every superstep, enabling several powerful capabilities like human-in-the-loop, "memory" between interactions and more. +[![PyPI - Version](https://img.shields.io/pypi/v/langgraph-checkpoint?label=%20)](https://pypi.org/project/langgraph-checkpoint/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph-checkpoint)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph-checkpoint)](https://pypistats.org/packages/langgraph-checkpoint) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) + +To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. + +## Quick Install + +```bash +uv add langgraph-checkpoint +``` + +## πŸ€” What is this? + +This library defines the base interface for LangGraph checkpointers. Checkpointers provide a persistence layer for LangGraph: they save graph state at every superstep, enabling human-in-the-loop, memory between interactions, durable execution, and more. + +## πŸ“– Documentation + +For full documentation, see the [API reference](https://reference.langchain.com/python/langgraph.checkpoint). For conceptual guides on persistence and memory, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). ## Key concepts @@ -24,7 +44,7 @@ You must pass these when invoking the graph as part of the configurable part of ### Serde -`langgraph_checkpoint` also defines protocol for serialization/deserialization (serde) and provides an default implementation (`langgraph.checkpoint.serde.jsonplus.JsonPlusSerializer`) that handles a wide variety of types, including LangChain and LangGraph primitives, datetimes, enums and more. +`langgraph-checkpoint` also defines protocol for serialization/deserialization (serde) and provides a default implementation (`langgraph.checkpoint.serde.jsonplus.JsonPlusSerializer`) that handles a wide variety of types, including LangChain and LangGraph primitives, datetimes, enums and more. > [!IMPORTANT] > **Checkpoint deserialization security:** By default the serializer allows any Python type found in checkpoint data. New applications should set the environment variable `LANGGRAPH_STRICT_MSGPACK=true` or pass an explicit `allowed_msgpack_modules` list to `JsonPlusSerializer` to restrict deserialization to known-safe types. @@ -89,3 +109,13 @@ checkpointer.get(read_config) # list checkpoints list(checkpointer.list(read_config)) ``` + +## πŸ“• Releases & Versioning + +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/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](https://docs.langchain.com/oss/python/contributing/overview). diff --git a/libs/cli/README.md b/libs/cli/README.md index d3b130e86..cac7808bb 100644 --- a/libs/cli/README.md +++ b/libs/cli/README.md @@ -1,29 +1,47 @@ # LangGraph CLI -The official command-line interface for LangGraph, providing tools to create, develop, and deploy LangGraph applications. +[![PyPI - Version](https://img.shields.io/pypi/v/langgraph-cli?label=%20)](https://pypi.org/project/langgraph-cli/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph-cli)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph-cli)](https://pypistats.org/packages/langgraph-cli) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) -## Installation +To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. + +## Quick Install -Install via pip: ```bash -pip install langgraph-cli +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](https://reference.langchain.com/python/langgraph-cli). For conceptual guides and tutorials, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). + For development mode with hot reloading: + ```bash -pip install "langgraph-cli[inmem]" +uv add "langgraph-cli[inmem]" ``` ## Commands ### `langgraph new` 🌱 -Create a new LangGraph project from a template + +Create a new LangGraph project from a template. + ```bash langgraph new [PATH] --template TEMPLATE_NAME ``` ### `langgraph dev` πŸƒβ€β™€οΈ -Run LangGraph API server in development mode with hot reloading + +Run LangGraph API server in development mode with hot reloading. + ```bash langgraph dev [OPTIONS] --host TEXT Host to bind to (default: 127.0.0.1) @@ -35,7 +53,9 @@ langgraph dev [OPTIONS] ``` ### `langgraph up` πŸš€ -Launch LangGraph API server in Docker + +Launch LangGraph API server in Docker. + ```bash langgraph up [OPTIONS] -p, --port INTEGER Port to expose (default: 8123) @@ -47,7 +67,9 @@ langgraph up [OPTIONS] ``` ### `langgraph build` -Build a Docker image for your LangGraph application + +Build a Docker image for your LangGraph application. + ```bash langgraph build -t IMAGE_TAG [OPTIONS] --platform TEXT Target platforms (e.g., linux/amd64,linux/arm64) @@ -56,7 +78,9 @@ langgraph build -t IMAGE_TAG [OPTIONS] ``` ### `langgraph dockerfile` -Generate a Dockerfile for custom deployments + +Generate a Dockerfile for custom deployments. + ```bash langgraph dockerfile SAVE_PATH [OPTIONS] -c, --config FILE Config file path @@ -68,18 +92,18 @@ The CLI uses a `langgraph.json` configuration file with these key settings: ```json { - "dependencies": ["langchain_openai", "./your_package"], // Required: Package dependencies + "dependencies": ["langchain_openai", "./your_package"], "graphs": { - "my_graph": "./your_package/file.py:graph" // Required: Graph definitions + "my_graph": "./your_package/file.py:graph" }, - "env": "./.env", // Optional: Environment variables - "python_version": "3.11", // Optional: Python version (3.11/3.12) - "pip_config_file": "./pip.conf", // Optional: pip configuration - "dockerfile_lines": [] // Optional: Additional Dockerfile commands + "env": "./.env", + "python_version": "3.11", + "pip_config_file": "./pip.conf", + "dockerfile_lines": [] } ``` -See the [full documentation](https://langchain-ai.github.io/langgraph/cloud/reference/cli/) for detailed configuration options. +See the [full documentation](https://reference.langchain.com/python/langgraph-cli) for detailed configuration options. ## Development @@ -87,19 +111,26 @@ To develop the CLI itself: 1. Clone the repository 2. Navigate to the CLI directory: `cd libs/cli` -3. Install development dependencies: `uv pip install` +3. Install development dependencies: `uv sync` 4. Make your changes to the CLI code 5. Test your changes: - ```bash - # Run CLI commands directly - uv run langgraph --help - - # Or use the examples - cd examples - uv pip install - uv run langgraph dev # or other commands - ``` -## License +```bash +# Run CLI commands directly +uv run langgraph --help -This project is licensed under the terms specified in the repository's LICENSE file. +# Or use the examples +cd examples +uv sync +uv run langgraph dev # or other commands +``` + +## πŸ“• Releases & Versioning + +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/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](https://docs.langchain.com/oss/python/contributing/overview). diff --git a/libs/cli/js-examples/README.md b/libs/cli/js-examples/README.md index 799fe90f1..5130cd4c4 100644 --- a/libs/cli/js-examples/README.md +++ b/libs/cli/js-examples/README.md @@ -10,7 +10,7 @@ This template demonstrates a simple chatbot implemented using [LangGraph.js](htt The core logic, defined in `src/agent/graph.ts`, showcases a straightforward chatbot that responds to user queries while maintaining context from previous messages. -## What it does +## πŸ€” What is this? The simple chatbot: @@ -20,6 +20,10 @@ The simple chatbot: This template provides a foundation that can be easily customized and extended to create more complex conversational agents. +## πŸ“– Documentation + +For JavaScript and TypeScript documentation, see the [LangGraph.js docs](https://docs.langchain.com/oss/javascript/langgraph/overview). LangGraph Studio also integrates with [LangSmith](https://smith.langchain.com/) for tracing and collaboration with teammates. + ## Getting Started Assuming you have already [installed LangGraph Studio](https://github.com/langchain-ai/langgraph-studio?tab=readme-ov-file#download), to set up: diff --git a/libs/langgraph/README.md b/libs/langgraph/README.md index b02d64015..b6267fd46 100644 --- a/libs/langgraph/README.md +++ b/libs/langgraph/README.md @@ -1,100 +1,45 @@ -
- - - - - LangGraph Logo - - -
+# πŸ¦œπŸ•ΈοΈ LangGraph -
-

Low-level orchestration framework for building stateful agents.

-
+[![PyPI - Version](https://img.shields.io/pypi/v/langgraph?label=%20)](https://pypi.org/project/langgraph/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph)](https://pypistats.org/packages/langgraph) +[![Open Issues](https://img.shields.io/github/issues-raw/langchain-ai/langgraph)](https://github.com/langchain-ai/langgraph/issues) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) -
- PyPI - License - PyPI - Downloads - Version - Open Issues - Docs - Twitter / X -
+Looking for the JS/TS version? Check out [LangGraph.js](https://github.com/langchain-ai/langgraphjs). -
+To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. -Trusted by companies shaping the future of agents – including Klarna, Replit, Elastic, and more – LangGraph is a low-level orchestration framework for building, managing, and deploying long-running, stateful agents. +## Quick Install -## Get started - -Install LangGraph: - -``` -pip install -U langgraph +```bash +uv add langgraph ``` -Create a simple workflow: +## πŸ€” What is this? -```python -from langgraph.graph import START, StateGraph -from typing_extensions import TypedDict +LangGraph is a low-level orchestration framework for building, managing, and deploying long-running, stateful agents. LangGraph provides the infrastructure for durable execution, streaming, human-in-the-loop, persistence, memory, and more. +We recommend you use LangGraph when you have advanced needs that require a combination of deterministic and agentic workflows, heavy customization, and carefully controlled latency. Use [LangChain](https://docs.langchain.com/oss/python/langchain/overview) when you want to quickly build agents and applications powered by LLMs using pre-built agent architectures and model integrations. -class State(TypedDict): - text: str +LangChain [agents](https://docs.langchain.com/oss/python/langchain/agents) are built on top of LangGraph in order to provide durable execution, streaming, human-in-the-loop, persistence, and more. (You do not need to know LangGraph for basic LangChain agent usage.) +Trusted by companies shaping the future of agents – including Klarna, Replit, Elastic, and more – LangGraph is used to ship AI applications at scale. -def node_a(state: State) -> dict: - return {"text": state["text"] + "a"} +## πŸ“– Documentation +For full documentation, see the [API reference](https://reference.langchain.com/python/langgraph/). For conceptual guides, tutorials, and examples on using LangGraph, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). Get started with the [LangGraph Quickstart](https://docs.langchain.com/oss/python/langgraph/quickstart). -def node_b(state: State) -> dict: - return {"text": state["text"] + "b"} +## πŸ“• Releases & Versioning +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies. -graph = StateGraph(State) -graph.add_node("node_a", node_a) -graph.add_node("node_b", node_b) -graph.add_edge(START, "node_a") -graph.add_edge("node_a", "node_b") +## πŸ’ Contributing -print(graph.compile().invoke({"text": ""})) -# {'text': 'ab'} -``` +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. -Get started with the [LangGraph Quickstart](https://docs.langchain.com/oss/python/langgraph/quickstart). - -To quickly build agents with LangChain's `create_agent` (built on LangGraph), see the [LangChain Agents documentation](https://docs.langchain.com/oss/python/langchain/agents). - -## Core benefits - -LangGraph provides low-level supporting infrastructure for *any* long-running, stateful workflow or agent. LangGraph does not abstract prompts or architecture, and provides the following central benefits: - -- [Durable execution](https://docs.langchain.com/oss/python/langgraph/durable-execution): Build agents that persist through failures and can run for extended periods, automatically resuming from exactly where they left off. -- [Human-in-the-loop](https://docs.langchain.com/oss/python/langgraph/interrupts): Seamlessly incorporate human oversight by inspecting and modifying agent state at any point during execution. -- [Comprehensive memory](https://docs.langchain.com/oss/python/langgraph/memory): Create truly stateful agents with both short-term working memory for ongoing reasoning and long-term persistent memory across sessions. -- [Debugging with LangSmith](http://www.langchain.com/langsmith): Gain deep visibility into complex agent behavior with visualization tools that trace execution paths, capture state transitions, and provide detailed runtime metrics. -- [Production-ready deployment](https://docs.langchain.com/langsmith/app-development): Deploy sophisticated agent systems confidently with scalable infrastructure designed to handle the unique challenges of stateful, long-running workflows. - -## LangGraph’s ecosystem - -While LangGraph can be used standalone, it also integrates seamlessly with any LangChain product, giving developers a full suite of tools for building agents. To improve your LLM application development, pair LangGraph with: - -- [LangSmith](http://www.langchain.com/langsmith) β€” Helpful for agent evals and observability. Debug poor-performing LLM app runs, evaluate agent trajectories, gain visibility in production, and improve performance over time. -- [LangSmith Deployment](https://docs.langchain.com/langsmith/deployments) β€” Deploy and scale agents effortlessly with a purpose-built deployment platform for long running, stateful workflows. Discover, reuse, configure, and share agents across teams β€” and iterate quickly with visual prototyping in [LangGraph Studio](https://docs.langchain.com/oss/python/langgraph/studio). -- [LangChain](https://docs.langchain.com/oss/python/langchain/overview) – Provides integrations and composable components to streamline LLM application development. - -> [!NOTE] -> Looking for the JS version of LangGraph? See the [JS repo](https://github.com/langchain-ai/langgraphjs) and the [JS docs](https://docs.langchain.com/oss/javascript/langgraph/overview). - -## Additional resources - -- [Guides](https://docs.langchain.com/oss/python/langgraph/guides): Quick, actionable code snippets for topics such as streaming, adding memory & persistence, and design patterns (e.g. branching, subgraphs, etc.). -- [Reference](https://reference.langchain.com/python/langgraph/): Detailed reference on core classes, methods, how to use the graph and checkpointing APIs, and higher-level prebuilt components. -- [Examples](https://docs.langchain.com/oss/python/langgraph/agentic-rag): Guided examples on getting started with LangGraph. -- [LangChain Forum](https://forum.langchain.com/): Connect with the community and share all of your technical questions, ideas, and feedback. -- [LangChain Academy](https://academy.langchain.com/courses/intro-to-langgraph): Learn the basics of LangGraph in our free, structured course. -- [Case studies](https://www.langchain.com/built-with-langgraph): Hear how industry leaders use LangGraph to ship AI applications at scale. +For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview). ## Acknowledgements diff --git a/libs/prebuilt/README.md b/libs/prebuilt/README.md index 6a7d1e1a6..b97ac6715 100644 --- a/libs/prebuilt/README.md +++ b/libs/prebuilt/README.md @@ -1,16 +1,36 @@ # LangGraph Prebuilt -This library defines high-level APIs for creating and executing LangGraph agents and tools. +[![PyPI - Version](https://img.shields.io/pypi/v/langgraph-prebuilt?label=%20)](https://pypi.org/project/langgraph-prebuilt/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph-prebuilt)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph-prebuilt)](https://pypistats.org/packages/langgraph-prebuilt) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) + +To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. + +## Quick Install + +```bash +uv add langgraph +``` + +## πŸ€” What is this? + +This library defines high-level APIs for creating and executing LangGraph agents and tools. It includes prebuilt components such as `create_react_agent`, `ToolNode`, validation helpers, and Agent Inbox schemas. + +## πŸ“– Documentation + +For full documentation, see the [API reference](https://reference.langchain.com/python/langgraph.prebuilt/). For conceptual guides and tutorials, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). > [!IMPORTANT] -> This library is meant to be bundled with `langgraph`, don't install it directly +> This library is bundled with `langgraph`; most users should install `langgraph` instead of installing `langgraph-prebuilt` directly. ## Agents -`langgraph-prebuilt` provides an [implementation](https://langchain-ai.github.io/langgraph/reference/prebuilt/#langgraph.prebuilt.chat_agent_executor.create_react_agent) of a tool-calling [ReAct-style](https://langchain-ai.github.io/langgraph/concepts/agentic_concepts/#react-implementation) agent - `create_react_agent`: +`langgraph-prebuilt` provides an [implementation](https://reference.langchain.com/python/langgraph.prebuilt/chat_agent_executor/create_react_agent) of a tool-calling ReAct-style agent - `create_react_agent`: ```bash -pip install langchain-anthropic +uv add langchain-anthropic ``` ```python @@ -39,7 +59,7 @@ app.invoke( ### ToolNode -`langgraph-prebuilt` provides an [implementation](https://langchain-ai.github.io/langgraph/reference/prebuilt/#langgraph.prebuilt.tool_node.ToolNode) of a node that executes tool calls - `ToolNode`: +`langgraph-prebuilt` provides an [implementation](https://reference.langchain.com/python/langgraph.prebuilt/tool_node/ToolNode) of a node that executes tool calls - `ToolNode`: ```python from langgraph.prebuilt import ToolNode @@ -61,7 +81,7 @@ tool_node.invoke({"messages": [ai_message]}) ### ValidationNode -`langgraph-prebuilt` provides an [implementation](https://langchain-ai.github.io/langgraph/reference/prebuilt/#langgraph.prebuilt.tool_validator.ValidationNode) of a node that validates tool calls against a pydantic schema - `ValidationNode`: +`langgraph-prebuilt` provides an [implementation](https://reference.langchain.com/python/langgraph.prebuilt/tool_validator/ValidationNode) of a node that validates tool calls against a pydantic schema - `ValidationNode`: ```python from pydantic import BaseModel, field_validator @@ -114,4 +134,14 @@ def my_graph_function(): if response['type'] == "response": # Do something with the response ... -``` \ No newline at end of file +``` + +## πŸ“• Releases & Versioning + +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/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](https://docs.langchain.com/oss/python/contributing/overview). diff --git a/libs/sdk-js/README.md b/libs/sdk-js/README.md index c12e9310e..924e755a9 100644 --- a/libs/sdk-js/README.md +++ b/libs/sdk-js/README.md @@ -1 +1,11 @@ -This repository has been moved to [langchain-ai/langgraphjs](https://github.com/langchain-ai/langgraphjs/tree/main/libs/sdk). \ No newline at end of file +# LangGraph JavaScript SDK + +Looking for the JS/TS version? Check out [LangGraph.js](https://github.com/langchain-ai/langgraphjs). + +## πŸ€” What is this? + +This package has moved to [langchain-ai/langgraphjs](https://github.com/langchain-ai/langgraphjs/tree/main/libs/sdk). + +## πŸ“– Documentation + +For JavaScript and TypeScript documentation, see the [LangGraph.js docs](https://docs.langchain.com/oss/javascript/langgraph/overview). diff --git a/libs/sdk-py/README.md b/libs/sdk-py/README.md index 6b7b35f4c..53fae13a9 100644 --- a/libs/sdk-py/README.md +++ b/libs/sdk-py/README.md @@ -1,17 +1,30 @@ # LangGraph Python SDK -This repository contains the Python SDK for interacting with the LangSmith Deployment REST API. +[![PyPI - Version](https://img.shields.io/pypi/v/langgraph-sdk?label=%20)](https://pypi.org/project/langgraph-sdk/#history) +[![PyPI - License](https://img.shields.io/pypi/l/langgraph-sdk)](https://opensource.org/licenses/MIT) +[![PyPI - Downloads](https://img.shields.io/pepy/dt/langgraph-sdk)](https://pypistats.org/packages/langgraph-sdk) +[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss) -## Quick Start +To help you ship LangGraph apps to production faster, check out [LangSmith](https://www.langchain.com/langsmith). +[LangSmith](https://www.langchain.com/langsmith) is a unified developer platform for building, testing, and monitoring LLM applications. -To get started with the Python SDK, [install the package](https://pypi.org/project/langgraph-sdk/) +## Quick Install ```bash -pip install -U langgraph-sdk +uv add langgraph-sdk ``` -You will need a running LangGraph API server. If you're running a server locally using `langgraph-cli`, SDK will automatically point at `http://localhost:8123`, otherwise -you would need to specify the server URL when creating a client. +## πŸ€” What is this? + +This library provides the Python SDK for interacting with the LangGraph API. Use it to connect to a running LangGraph API server, manage assistants and threads, and stream runs from Python applications. + +You will need a running LangGraph API server. If you're running a server locally using `langgraph-cli`, the SDK will automatically point at `http://localhost:8123`; otherwise, specify the server URL when creating a client. + +## πŸ“– Documentation + +For full documentation, see the [API reference](https://reference.langchain.com/python/langgraph-sdk/). For conceptual guides and tutorials, see the [LangGraph Docs](https://docs.langchain.com/oss/python/langgraph/overview). + +## Quick Start ```python from langgraph_sdk import get_client @@ -43,9 +56,7 @@ async for chunk in client.runs.stream(thread['thread_id'], agent['assistant_id'] ## Thread-Centric Streaming (v3) -`client.threads.stream()` returns a context manager that owns the SSE session for one -thread. Typed projections β€” values snapshots, message streams, tool calls, custom -events β€” all share the same underlying connection. +`client.threads.stream()` returns a context manager that owns the SSE session for one thread. Typed projections β€” values snapshots, message streams, tool calls, custom events β€” all share the same underlying connection. ```python from langgraph_sdk import get_client @@ -73,3 +84,13 @@ async with client.threads.stream( final = await thread.output # terminal state values ``` + +## πŸ“• Releases & Versioning + +See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/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](https://docs.langchain.com/oss/python/contributing/overview).