Skip to main content

smriti — plain-text memory for AI agents: write through a filter, compress to a hook, inject the index, recall by hook, prune the rest

smriti

Plain-text memory for AI agents.
Markdown files — no database, no embeddings, no dependencies.


from smriti import Memory
mem = Memory("./memory")

mem.write("Use Postgres, not Mongo, for the ledger", type="decision")

mem.context()                  # the index — inject into your prompt every turn
mem.recall("postgres ledger")  # ranked matches, plus what they link to (one hop)
mem.get("use-postgres-for-the-ledger").body
mem.prune()                    # stale / duplicate / broken-link memories

Install  ·  pip install agent-smriti  ·  or copy smriti.py (stdlib, Python 3.10+)

The four rules  ·  write what's durable  ·  compress to a hook + seed  ·  recall by hook  ·  prune the rest

Limits  ·  recall is lexical (the model does the semantics over context())  ·  the filter checks shape, not worth  ·  built for agent scale


The format is the whole spec  ·  Benchmarks — local-model A/B: smriti 100% vs no-memory 25% at ~⅓ the context  ·  MIT

Metadata

Release files for agent-smriti 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-smriti 0.1.0
File Size Uploaded
agent_smriti-0.1.0.tar.gz 7.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-smriti 0.1.0
File Interpreter ABI Platform
agent_smriti-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.5 kB

Release files / agent_smriti-0.1.0.tar.gz

Download URL agent_smriti-0.1.0.tar.gz
Size 7.5 kB
Tags Source
SHA-256 checksum
How to use checksums
36e7681b608626ea4cafae166fa7fb885e5b7e1df438de55869c25f405c1be5d
BLAKE2b-256 checksum
How to use checksums
f50f23aa054fc16fccb50e1708e89ee636b826301ec7ede46f833d706f708382
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 27, 2026.

Transparency log

Release files / agent_smriti-0.1.0-py3-none-any.whl

Download URL agent_smriti-0.1.0-py3-none-any.whl
Size 8.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b2901f03992db83fef68eb3046932eaeb299af6ad48dc8903446b41a3d2dbc58
BLAKE2b-256 checksum
How to use checksums
d13050d3997d190c4157a58aa2dddcedf68ec3795f733c5a95d23b900a5ccfbe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 27, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page