Skip to main content

riffdb-langgraph

riffdb-langgraph is a compiled RiffDB checkpoint-saver adapter (RiffDBCheckpointSaver) for LangGraph (langgraph>=1.1.0, langgraph-checkpoint>=4.0.0). It is an out-of-tree integration: no LangGraph-specific code or vocabulary belongs in the RiffDB repository.

The adapter implements both synchronous and asynchronous BaseCheckpointSaver surfaces and passes all eight capability suites (81 tests) in the upstream langgraph-checkpoint-conformance package:

  • put (put, aput)
  • put_writes (put_writes, aput_writes)
  • get_tuple (get_tuple, aget_tuple)
  • list (list, alist)
  • delete_thread (delete_thread, adelete_thread)
  • delete_for_runs (delete_for_runs, adelete_for_runs)
  • copy_thread (copy_thread, acopy_thread)
  • prune (prune, aprune)

Usage

from langgraph.graph import START, END, StateGraph
from riffdb_langgraph import RiffDBCheckpointSaver

with RiffDBCheckpointSaver("riffdb://langgraph-development") as checkpointer:
    graph = builder.compile(checkpointer=checkpointer)
    result = graph.invoke(
        {"messages": ["hello"]},
        config={"configurable": {"thread_id": "thread-1"}},
    )

RiffDB TLS and credential material is supplied through protected environment configuration (RIFFDB_LANGGRAPH_ENDPOINT and RIFFDB_LANGGRAPH_CREDENTIAL_FILE) described in DESIGN.md; it is never embedded in the checkpointer URI.

Development and Verification

make check
make conformance

make conformance starts a disposable riffdb dev instance, runs sync and async StateGraph fan-out smoke tests, and executes the full langgraph-checkpoint-conformance validation suite against the live server.

RiffDB compatibility CI

This adapter owns its RiffDB compatibility checks. Pull requests compile the application sources and verify existing locks and generated artifacts against the full commit in .github/riffdb-revision. Scheduled checks use RiffDB main; manual dispatch accepts a full commit or main. Failures are reported here and do not block RiffDB itself.

To upgrade, update the pin, migrate sources as needed, review the result of riffdb application lock --write, and verify with riffdb application check. Commit the pin and migration together in this repository.

Metadata

Release files for riffdb-langgraph 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for riffdb-langgraph 0.2.2
File Size Uploaded Provenance Actions
riffdb_langgraph-0.2.2.tar.gz 158.2 kB Without provenance Details for riffdb_langgraph-0.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for riffdb-langgraph 0.2.2
File Interpreter ABI Platform Actions
riffdb_langgraph-0.2.2-py3-none-any.whl Python 3 none any Details for riffdb_langgraph-0.2.2-py3-none-any.whl

Total release size: 182.7 kB

Release files / riffdb_langgraph-0.2.2.tar.gz

Download URL riffdb_langgraph-0.2.2.tar.gz
Size 158.2 kB
Tags Source
SHA-256 checksum
How to use checksums
feae5464f3f418380c341d76655bdf232f5e48d30159965dac1f0a630f2d4501
BLAKE2b-256 checksum
How to use checksums
4e217f3bc70395990573844d05eeaba005316fb171b0f01ef5da586a27263db0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / riffdb_langgraph-0.2.2-py3-none-any.whl

Download URL riffdb_langgraph-0.2.2-py3-none-any.whl
Size 24.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9918666f3a7150d4920d03785577afc7b72a42bf02df6b1e7491a0818e0d43a1
BLAKE2b-256 checksum
How to use checksums
fda9c322e0794ea7d91e7d2155016f10e9ba042e3fd394643e934ffe4fde227a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for riffdb-langgraph 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page