Skip to main content

Momento-Backed Chat Memory

For distributed, serverless persistence across chat sessions, you can swap in a Momento-backed chat message history. Because a Momento cache is instantly available and requires zero infrastructure maintenance, it's a great way to get started with chat history whether building locally or in production.


You will need to install the Momento Client Library in your project. Given Momento's compatibility with Node.js, browser, and edge environments, ensure you install the relevant package.

To install for Node.js:

npm install @gomomento/sdk

To install for browser/edge workers:

npm install @gomomento/sdk-web
npm install @langchain/openai @langchain/community

You will also need an API key from Momento. You can sign up for a free account here.


To distinguish one chat history session from another, we need a unique sessionId. You may also provide an optional sessionTtl to make sessions expire after a given number of seconds.

import {
} from "@gomomento/sdk"; // `from "gomomento/sdk-web";` for browser/edge
import { BufferMemory } from "langchain/memory";
import { ChatOpenAI } from "@langchain/openai";
import { ConversationChain } from "langchain/chains";
import { MomentoChatMessageHistory } from "@langchain/community/stores/message/momento";

// See for connection options
const client = new CacheClient({
configuration: Configurations.Laptop.v1(),
credentialProvider: CredentialProvider.fromEnvironmentVariable({
environmentVariableName: "MOMENTO_API_KEY",
defaultTtlSeconds: 60 * 60 * 24,

// Create a unique session ID
const sessionId = new Date().toISOString();
const cacheName = "langchain";

const memory = new BufferMemory({
chatHistory: await MomentoChatMessageHistory.fromProps({
sessionTtl: 300,
`cacheName=${cacheName} and sessionId=${sessionId} . This will be used to store the chat history. You can inspect the values at your Momento console at`

const model = new ChatOpenAI({
model: "gpt-3.5-turbo",
temperature: 0,

const chain = new ConversationChain({ llm: model, memory });

const res1 = await{ input: "Hi! I'm Jim." });
console.log({ res1 });
res1: {
text: "Hello Jim! It's nice to meet you. My name is AI. How may I assist you today?"

const res2 = await{ input: "What did I just say my name was?" });
console.log({ res2 });

res1: {
text: "You said your name was Jim."

// See the chat history in the Momento
console.log(await memory.chatHistory.getMessages());

API Reference:

Help us out by providing feedback on this documentation page: