[PR #5679] feat: add Elasticsearch checkpointer implementation #4583

Closed
opened 2026-02-20 17:50:25 -05:00 by yindo · 0 comments
Owner

Original Pull Request: https://github.com/langchain-ai/langgraph/pull/5679

State: closed
Merged: No


Add complete Elasticsearch checkpointer for LangGraph with:

  • Synchronous and asynchronous implementations
  • ES_URL and ES_API_KEY authentication only
  • Elasticsearch 8.17+, <9.0 compatibility
  • Optimized index schemas for checkpoints and writes
  • Bulk operations for performance
  • Comprehensive test suite and documentation
  • BaseCheckpointSaver interface compliance

The implementation includes:

  • ElasticsearchSaver (sync) and AsyncElasticsearchSaver (async)
  • Proper error handling and connection management
  • Thread-based checkpoint isolation
  • Checkpoint history and retrieval functionality
  • Example usage and test scripts

Tested with real Elasticsearch cluster and passes all unit tests.

Thank you for contributing to LangGraph! Follow these steps to mark your pull request as ready for review. If any of these steps are not completed, your PR will not be considered for review.

  • PR title: Follows the format: {TYPE}({SCOPE}): {DESCRIPTION}

    • Examples:
      • feat(core): add multi-tenant support
      • fix(cli): resolve flag parsing error
      • docs(openai): update API usage examples
    • Allowed {TYPE} values:
      • feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert, release
    • Allowed {SCOPE} values (optional):
      • langgraph, docs, cli, checkpoint, checkpoint-postgres, checkpoint-sqlite, prebuilt, scheduler-kafka, sdk-py
    • Once you've written the title, please delete this checklist item; do not include it in the PR.
  • PR message: Delete this entire checklist and replace with

    • Description: a description of the change. Include a closing keyword if applicable.
    • Issue: the issue # it fixes, if applicable
    • Dependencies: any dependencies required for this change
    • Twitter handle: if your PR gets announced, and you'd like a mention, we'll gladly shout you out!
  • Add tests and docs: If you're adding a new integration, you must include:

    1. A test for the integration, preferably unit tests that do not rely on network access,
    2. An example notebook showing its use. It lives in docs/docs/integrations directory.
  • Lint and test: Run make format, make lint and make test from the root of the package(s) you've modified. We will not consider a PR unless these three are passing in CI. See contribution guidelines for more.

Additional guidelines:

  • Make sure optional dependencies are imported within a function.
  • Please do not add dependencies to pyproject.toml files (even optional ones) unless they are required for unit tests.
  • Most PRs should not touch more than one package.
  • Changes should be backwards compatible.
**Original Pull Request:** https://github.com/langchain-ai/langgraph/pull/5679 **State:** closed **Merged:** No --- Add complete Elasticsearch checkpointer for LangGraph with: - Synchronous and asynchronous implementations - ES_URL and ES_API_KEY authentication only - Elasticsearch 8.17+, <9.0 compatibility - Optimized index schemas for checkpoints and writes - Bulk operations for performance - Comprehensive test suite and documentation - BaseCheckpointSaver interface compliance The implementation includes: - ElasticsearchSaver (sync) and AsyncElasticsearchSaver (async) - Proper error handling and connection management - Thread-based checkpoint isolation - Checkpoint history and retrieval functionality - Example usage and test scripts Tested with real Elasticsearch cluster and passes all unit tests. Thank you for contributing to LangGraph! Follow these steps to mark your pull request as ready for review. **If any of these steps are not completed, your PR will not be considered for review.** - [ ] **PR title**: Follows the format: {TYPE}({SCOPE}): {DESCRIPTION} - Examples: - feat(core): add multi-tenant support - fix(cli): resolve flag parsing error - docs(openai): update API usage examples - Allowed `{TYPE}` values: - feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert, release - Allowed `{SCOPE}` values (optional): - langgraph, docs, cli, checkpoint, checkpoint-postgres, checkpoint-sqlite, prebuilt, scheduler-kafka, sdk-py - Once you've written the title, please delete this checklist item; do not include it in the PR. - [ ] **PR message**: ***Delete this entire checklist*** and replace with - **Description:** a description of the change. Include a [closing keyword](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword) if applicable. - **Issue:** the issue # it fixes, if applicable - **Dependencies:** any dependencies required for this change - **Twitter handle:** if your PR gets announced, and you'd like a mention, we'll gladly shout you out! - [ ] **Add tests and docs**: If you're adding a new integration, you must include: 1. A test for the integration, preferably unit tests that do not rely on network access, 2. An example notebook showing its use. It lives in `docs/docs/integrations` directory. - [ ] **Lint and test**: Run `make format`, `make lint` and `make test` from the root of the package(s) you've modified. We will not consider a PR unless these three are passing in CI. See [contribution guidelines](https://github.com/langchain-ai/langgraph/blob/main/CONTRIBUTING.md) for more. Additional guidelines: - Make sure optional dependencies are imported within a function. - Please do not add dependencies to `pyproject.toml` files (even optional ones) unless they are **required** for unit tests. - Most PRs should not touch more than one package. - Changes should be backwards compatible.
yindo added the pull-request label 2026-02-20 17:50:25 -05:00
yindo closed this issue 2026-02-20 17:50:25 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/langgraph#4583