Clone and install

Clone the repository, start Aerospike, and install Python dependencies.

Clone the repository

1. Clone the langgraph-aerospike repository and change into it:

   git clone https://github.com/aerospike/langgraph-aerospike.git
   cd langgraph-aerospike

Start Aerospike Database

1. Start Aerospike in Docker:

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

2. Verify the database is listening on port 3000:

   nc -z localhost 3000 && echo 'Aerospike database is running.'

   Expected result

   Connection to localhost port 3000 [tcp/hbci] succeeded!
   Aerospike database is running.

Tip

If a container named aerospike already exists from a previous run, remove it with docker rm -f aerospike before starting a new one.

Install dependencies

1. From the repository root, install dependencies:

   uv sync

   Expected result

   Using CPython 3.13.11 interpreter at: /opt/homebrew/opt/python@3.13/bin/python3.13
   Creating virtual environment at: .venv
   Resolved 85 packages in 18ms
         Built langgraph-checkpoint-aerospike @ file:///.../langgraph-checkpoint-aerospike
         Built langgraph-store-aerospike @ file:///.../langgraph-store-aerospike
   Prepared 10 packages in 920ms
   Installed 78 packages in 220ms
    + aerospike==19.2.2
    + langgraph-checkpoint-aerospike==0.2.1 (from file:///.../langgraph-checkpoint-aerospike)
    + langgraph-store-aerospike==0.2.1 (from file:///.../langgraph-store-aerospike)
    ...

2. Verify the AerospikeSaver import:

   AerospikeSaver is the plugin LangGraph uses to save and load checkpoints in Aerospike.

   uv run python -c "from langgraph.checkpoint.aerospike import AerospikeSaver; print('ok')"

   Expected result

   ok

Checklist

• I’ve cloned the langgraph-aerospike repository.
• I’ve started Aerospike Database in Docker.
• I’ve run uv sync from the repository root.
• I’ve verified the AerospikeSaver import.