langgraph-store-aerospike 0.2.0

Aerospike-based store base for LangGraph

LangGraph Store Aerospike

Store LangGraph state and data in Aerospike using the provided AerospikeStore.

Installation

pip install -U langgraph-store-aerospike

Usage

1. Bring up Aerospike locally using prebuilt Aerospike Docker Image:

docker run -d --name aerospike -p 3000-3002:3000-3002 container.aerospike.com/aerospike/aerospike-server

2. Point the store at your cluster (Default):

   • AEROSPIKE_HOST=127.0.0.1
   • AEROSPIKE_PORT=3000
   • AEROSPIKE_NAMESPACE=langgraph (default namespace for the store)
   • AEROSPIKE_SET=store (default set name)

3. Use in your application:

   import aerospike
   from langgraph.store.aerospike import AerospikeStore
   from langgraph.store.base import PutOp, GetOp, SearchOp

   client = aerospike.client({"hosts": [("127.0.0.1", 3000)]}).connect()

   store = AerospikeStore(
       client=client,
       namespace="test",
       set="langgraph_store"
   )
   store.put(
       namespace=("users", "profiles"),
       key="user_123",
       value={"name": "Alice", "age": 30}
   )

   # Get data
   item = store.get(namespace=("users", "profiles"), key="user_123")
   print(item.value)  # {"name": "Alice", "age": 30}

   # Batch operations
   ops = [
       PutOp(namespace=("documents",), key="doc1", value={"status": "draft"}),
       PutOp(namespace=("documents",), key="doc2", value={"status": "published"}),
       GetOp(namespace=("documents",), key="doc1"),
   ]
   results = store.batch(ops)

   # Search with filters
   search_results = store.search(
       namespace_prefix=("documents",),
       filter={"status": {"$eq": "draft"}},
       limit=10
   )

   # Delete item
   store.delete(namespace=("users", "profiles"), key="user_123")