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. +[](https://pypi.org/project/langgraph-checkpoint-conformance/#history) +[](https://opensource.org/licenses/MIT) +[](https://pypistats.org/packages/langgraph-checkpoint-conformance) +[](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. +[](https://pypi.org/project/langgraph-checkpoint-postgres/#history) +[](https://opensource.org/licenses/MIT) +[](https://pypistats.org/packages/langgraph-checkpoint-postgres) +[](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`) +[](https://pypi.org/project/langgraph-checkpoint-sqlite/#history) +[](https://opensource.org/licenses/MIT) +[](https://pypistats.org/packages/langgraph-checkpoint-sqlite) +[](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. +[](https://pypi.org/project/langgraph-checkpoint/#history) +[](https://opensource.org/licenses/MIT) +[](https://pypistats.org/packages/langgraph-checkpoint) +[](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. +[](https://pypi.org/project/langgraph-cli/#history) +[](https://opensource.org/licenses/MIT) +[](https://pypistats.org/packages/langgraph-cli) +[](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 @@ -