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, RIFFDB_LANGGRAPH_CREDENTIAL_FILE, and for direct TLS with a custom trust root, both RIFFDB_LANGGRAPH_TRUST_ROOT and RIFFDB_LANGGRAPH_SERVER_NAME) 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.5

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

Built distribution (wheel)

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

Total release size: 183.4 kB

Release files / riffdb_langgraph-0.2.5.tar.gz

Download URL riffdb_langgraph-0.2.5.tar.gz
Size 158.7 kB
Tags Source
SHA-256 checksum
How to use checksums
abd1df1f0f6e20b06e03d979ef6d225345e070a1def50a36ae11528f6b7f12f1
BLAKE2b-256 checksum
How to use checksums
1d21b1c7544ab8bcbd3b448de58d5698f7dba07b65effa78d5b1cb04b6e9b9d4
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.5-py3-none-any.whl

Download URL riffdb_langgraph-0.2.5-py3-none-any.whl
Size 24.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d4a20b97f0ddd2c13ac3cbb4d74dfe6f27600baeda7596417063fcb67a0811fa
BLAKE2b-256 checksum
How to use checksums
0f2a2403d8d681fb199dd962dd1cf7e832657d4a7c9c6b92e7e46f7e41dbb8c0
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.5

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