cognitive-memory

Biologically-inspired agent memory with decay, consolidation, and tiered storage.

Install

npm install cognitive-memory

Requires Node.js 18+ or Bun. ESM-only.

Quick Start

import { CognitiveMemory, InMemoryAdapter, HashEmbeddingProvider } from "cognitive-memory";

const mem = new CognitiveMemory({
  adapter: new InMemoryAdapter(),
  embeddingProvider: new HashEmbeddingProvider(),
  userId: "user-1",
});

await mem.store({
  content: "User is allergic to shellfish",
  category: "core",
  importance: 0.95,
});

const { results } = await mem.search({ query: "what allergies?" });
for (const r of results) {
  console.log(r.memory.content, `(score: ${r.combinedScore.toFixed(2)})`);
}

For production, use OpenAIEmbeddingProvider and PostgresAdapter:

import { OpenAIEmbeddingProvider } from "cognitive-memory";
import { PostgresAdapter } from "cognitive-memory/adapters/postgres";

const mem = new CognitiveMemory({
  adapter: new PostgresAdapter({ connectionString: process.env.DATABASE_URL }),
  embeddingProvider: new OpenAIEmbeddingProvider({ apiKey: process.env.OPENAI_API_KEY }),
  userId: "user-1",
});

Docs

Full documentation, guides, and API reference at bhekanik.github.io/cognitive-memory.

License

MIT