Ensue
Shared Memory for AI Agents
Ensue provides a type-safe, persistent memory layer for AI agents and intelligent applications. Build smarter agents that remember and learn from their interactions.
Getting Started
This page hosts the assets and links to the current release 0f5f34b (2025-08-20).
Currently the ensue repository is not public, which means you'll need an access token to get started. This token will allow you to access the registries to pull docker images and install npm packages.
Get your access token: Send a direct message to @austinbaggio on X (Twitter)
Quick start:
Use our starter repository → that includes compatible services, Docker containers, and TypeScript libraries.
Setting up Ensue in Your Project
📦 NPM Packages
Install the TypeScript SDK and client libraries from our GitHub package registry (current version: v0.2.0-0f5f34b).
Add the following to .npmrc file in your project:
@o1-labs:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${ENSUE_NPM}
Note: Use the token provided by the team for ENSUE_NPM
See example .npmrc for reference.
Available Packages:
🐳 Docker Registry and Start the Storage Server
Deploy Ensue database instances using our multi-architecture Docker images.
Login to GitHub Container Registry:
echo $ENSUE_DOCKER | docker login ghcr.io -u your_github_username --password-stdin
Note: Use the token provided by the team for ENSUE_DOCKER
Pull the image:
docker pull ghcr.io/o1-labs/ensue:0f5f34b
Start the server
Run the storage server that you can connect to from your application using RpcClient from ensue-db-ts-client package
docker run --rm -it \
-p 8000:8000 \
-v $(pwd)/data:/data \
-v $(pwd)/srs:/srs \
ghcr.io/o1-labs/ensue:0f5f34b \
ensue-db \
--db-path /data/db
Documentation
Explore the complete API documentation for the Ensue SDK, including guides for implementing agentic memory patterns.
Source Downloads
Download the complete source code for both SDK packages (current version: v0.2.0-0f5f34b).