langgraph-checkpoint-hyperspace — Standalone LangGraph Checkpointer & Store for HyperspaceDB

A lightweight, zero-monolith LangGraph CheckpointSaver and Cross-Thread Memory Store backed by HyperspaceDB CSR KAG Topology and Lorentz Hyperbolic Manifolds.

Unlike langchain-hyperspace, this standalone package has zero dependency on langchain or langchain-core, making it ideal for lean production LangGraph deployments.

Key Capabilities

1. CSR KAG Execution Lineage & Fork Tracking
   • Automatically wires STEP_TRANSITION edges between consecutive checkpoints and FORKED_FROM edges when branching or time-traveling from an earlier state.
2. Lorentz Hyperboloid State Embeddings
   • Embeds serialized state snapshots onto the upper sheet of the $d$-dimensional Lorentz hyperboloid ($\mathbb{H}^{d-1}$) where radial distance encodes execution step depth.
3. Semantic State Recall & Time-Travel
   • saver.search_checkpoints("query") recalls relevant past states across execution branches using Lorentzian geodesic similarity.
   • saver.traverse_lineage(thread_id, start_checkpoint_id) walks the KAG execution graph in $O(1)$ per hop.

Installation

pip install langgraph-checkpoint-hyperspace

Quick Start

from langgraph_checkpoint_hyperspace import HyperspaceCheckpointSaver

checkpointer = HyperspaceCheckpointSaver(
    host="localhost",
    port=50051,
    collection_name="agent_checkpoints",
)

# Pass directly to any LangGraph StateGraph.compile(checkpointer=checkpointer)

License

Apache-2.0. Copyright © 2026 YARlabs.