cognitive-memory 0.3.0

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

cognitive-memory

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

Install

pip install cognitive-memory

Requires Python 3.10+.

Quick Start

from cognitive_memory import SyncCognitiveMemory

mem = SyncCognitiveMemory(embedder="hash")

mem.add("User is allergic to shellfish", category="core", importance=0.95)

response = mem.search("what allergies does the user have?")
for r in response.results:
    print(r.memory.content, f"(score: {r.combined_score:.2f})")

For production, use OpenAI embeddings (set OPENAI_API_KEY):

from cognitive_memory import CognitiveMemory

mem = CognitiveMemory()  # defaults to OpenAI embeddings

await mem.add("User prefers dark mode", category="semantic", importance=0.7)
response = await mem.search("UI preferences")

For sync usage in scripts and notebooks, use SyncCognitiveMemory (same API, no await).

Docs

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

License

MIT