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.3

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.3
File Size Uploaded Provenance Actions
riffdb_langgraph-0.2.3.tar.gz 158.7 kB Without provenance Details for riffdb_langgraph-0.2.3.tar.gz

Built distribution (wheel)

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

Total release size: 183.2 kB

Release files / riffdb_langgraph-0.2.3.tar.gz

Download URL riffdb_langgraph-0.2.3.tar.gz
Size 158.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f262788cd1199c674487fbacaefb4ac7086423b92ae1eed4768c5a4441d468cd
BLAKE2b-256 checksum
How to use checksums
a85951477fe6491dc92cfa45654cf34de1169ca7f6fdbf558c3ef08d2b800309
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.3-py3-none-any.whl

Download URL riffdb_langgraph-0.2.3-py3-none-any.whl
Size 24.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
50aee033fac71f35b6e16335f7816a161c82416599da4130beb0ba4a58e63bb3
BLAKE2b-256 checksum
How to use checksums
212f452a2efc4dab4832d67310defe9ae68aeb72bc0810334e5e7736e1b586a5
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.3

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