Skip to main content

Persistent memory for AI agents. Three methods. Zero infra.

Project description

kemi

Persistent memory for AI agents. Three methods. Zero infra.

from kemi import Memory

memory = Memory()  # SQLite + local embeddings, no API keys needed

memory.remember("user123", "User prefers dark mode")
memory.remember("user123", "User is vegetarian")

results = memory.recall("user123", "what are the user's preferences?")
# Returns ranked, deduplicated memories

memory.forget("user123")  # GDPR-compliant deletion

Install

# Zero dependencies — SQLite storage, no embedding (bring your own)
pip install kemi

# With local embeddings (no API key needed, ~130MB model download)
pip install kemi[local]

# With OpenAI embeddings
pip install kemi[openai]

Why kemi

Every existing memory library either hosts your data on their servers, requires Docker and 4 services to run, or locks you into a specific framework.

kemi is different:

  • Zero infrastructure — runs on your machine, single pip install
  • Your data — never leaves your machine, stored in SQLite by default
  • Bring your own embedding — OpenAI, local models, or any function
  • Framework agnostic — works with LangChain, CrewAI, AutoGen, or plain Python
  • 100% free — MIT license, no paid tiers, no cloud lock-in

Usage

Zero-config (local embeddings)

from kemi import Memory

memory = Memory()
memory.remember("user123", "User is vegetarian", importance=0.9)
results = memory.recall("user123", "food preferences")

With OpenAI embeddings

from kemi import Memory
from kemi.adapters.embedding.openai import OpenAIEmbedAdapter

memory = Memory(embed=OpenAIEmbedAdapter())
memory.remember("user123", "User prefers concise responses")
results = memory.recall("user123", "communication style")

Inject into system prompt

context = memory.context_block("user123", query="user preferences", max_tokens=500)
# Returns formatted string ready for system prompt injection

GDPR-compliant deletion

memory.forget("user123")               # Delete all memories for user
memory.forget("user123", memory_id)    # Delete one specific memory

How it works

kemi sits between your agent and your storage. It handles:

  • Semantic deduplication — "I'm vegetarian" and "I don't eat meat" are the same memory
  • Importance-weighted scoring — recent, important memories rank higher
  • Temporal decay — memories fade if never recalled
  • Conflict detection — flags contradictory memories for review
  • Lifecycle management — active → decaying → archived → deleted

Adapters

Type Default Available
Embedding fastembed (local) OpenAI, custom
Storage SQLite JSON, custom

License

MIT — free forever, no exceptions.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kemi-0.1.1.tar.gz (20.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kemi-0.1.1-py3-none-any.whl (19.3 kB view details)

Uploaded Python 3

File details

Details for the file kemi-0.1.1.tar.gz.

File metadata

  • Download URL: kemi-0.1.1.tar.gz
  • Upload date:
  • Size: 20.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for kemi-0.1.1.tar.gz
Algorithm Hash digest
SHA256 74801cb5707ab02037b1a84d6a8be8a9a8c637a7e9b832a06092bbbc2aebc994
MD5 f3da2f4f3c2148975d2454941de84a85
BLAKE2b-256 3ef886eb68543f6858b55aacbaefb7a022272e7dbb7e617ab8e3d7630df4aede

See more details on using hashes here.

File details

Details for the file kemi-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: kemi-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 19.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for kemi-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f0c03770f1b3e82f92f0279467278b8874c0e0dbd1d09d3d6856461f1586d0c6
MD5 16b6580309284a1f6e092b8fbe648cf3
BLAKE2b-256 271aa71eaa0a67c988cb1ad88757489ded4b2bd72017b4fd2579e1c95e9b96be

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page