lethe-memory
Python bindings to the Rust core of lethe, a self-improving memory store for LLM agents. Built with PyO3 + maturin, distributed as wheels.
Install
pip install lethe-memory
Use
from lethe_memory import MemoryStore
store = MemoryStore("./my_memories") # encoders default to MiniLM
store.add("I prefer window seats on flights", session_id="trip")
store.add("My wife needs aisle seats", session_id="trip")
store.add("I work at Google as a software engineer", session_id="work")
for hit in store.retrieve("What are my travel preferences?", k=5):
print(f" [{hit.score:.1f}] {hit.content}")
store.save()
The wheel ships the Rust lethe-core retrieval pipeline (BM25 + dense
hybrid, cross-encoder rerank, clustered RIF), the same code path the CLI
uses, exposed via PyO3 with Python::allow_threads around all native
work so multi-threaded Python callers see real parallelism.
Constructor knobs
MemoryStore(
path,
bi_encoder="Xenova/all-MiniLM-L6-v2",
cross_encoder="Xenova/ms-marco-MiniLM-L-6-v2",
rif_config=None, # RIFConfig(n_clusters=30, ...)
k_shallow=30,
k_deep=100,
confidence_threshold=4.0,
dedup_threshold=0.95,
)
See also
- Project landing page: architecture, benchmarks, research journey
lethe-cli(Homebrew:lethe): the standalone CLI
License: MIT.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lethe_memory-0.17.0-cp39-abi3-win_arm64.whl.
File metadata
- Download URL: lethe_memory-0.17.0-cp39-abi3-win_arm64.whl
- Upload date:
- Size: 23.2 MB
- Tags: CPython 3.9+, Windows ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db801382fd162a0d971c1ac5a2f40d0deedfc0fd13beb4f8d2f79ae17f8b658a
|
|
| MD5 |
bd28bf7b2b74f4297e7ae2c9fc41883c
|
|
| BLAKE2b-256 |
a29d06e47049928e714d7ae1a984dcb56205276ebb1c243bd458214257e509f2
|
Provenance
The following attestation bundles were made for lethe_memory-0.17.0-cp39-abi3-win_arm64.whl:
Publisher:
release-pypi.yml on teimurjan/lethe
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lethe_memory-0.17.0-cp39-abi3-win_arm64.whl -
Subject digest:
db801382fd162a0d971c1ac5a2f40d0deedfc0fd13beb4f8d2f79ae17f8b658a - Sigstore transparency entry: 2171994736
- Sigstore integration time:
-
Permalink:
teimurjan/lethe@7c8211e61f4cee602af80ae2fffc9703e048efb0 -
Branch / Tag:
refs/tags/lethe-v0.17.0 - Owner: https://github.com/teimurjan
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@7c8211e61f4cee602af80ae2fffc9703e048efb0 -
Trigger Event:
release
-
Statement type:
File details
Details for the file lethe_memory-0.17.0-cp39-abi3-win_amd64.whl.
File metadata
- Download URL: lethe_memory-0.17.0-cp39-abi3-win_amd64.whl
- Upload date:
- Size: 23.1 MB
- Tags: CPython 3.9+, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8a5858092fb0f6559e9458f30ef6cc4c89389f58944f6115e2dffd589bf7c233
|
|
| MD5 |
c84b2f49ff95be03a5545a3c26ab7867
|
|
| BLAKE2b-256 |
6b68a9f786529bc48c447d7befbd615802123190aac1242d2a9e7b0365a4274f
|
Provenance
The following attestation bundles were made for lethe_memory-0.17.0-cp39-abi3-win_amd64.whl:
Publisher:
release-pypi.yml on teimurjan/lethe
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lethe_memory-0.17.0-cp39-abi3-win_amd64.whl -
Subject digest:
8a5858092fb0f6559e9458f30ef6cc4c89389f58944f6115e2dffd589bf7c233 - Sigstore transparency entry: 2171994757
- Sigstore integration time:
-
Permalink:
teimurjan/lethe@7c8211e61f4cee602af80ae2fffc9703e048efb0 -
Branch / Tag:
refs/tags/lethe-v0.17.0 - Owner: https://github.com/teimurjan
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@7c8211e61f4cee602af80ae2fffc9703e048efb0 -
Trigger Event:
release
-
Statement type:
File details
Details for the file lethe_memory-0.17.0-cp39-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: lethe_memory-0.17.0-cp39-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 44.3 MB
- Tags: CPython 3.9+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe62c22cfe95861c1fe9a87837f649bf06b1c8fcc63a13f8ddb44e83116daa69
|
|
| MD5 |
b9a245ac839f6c5353b849f2251fc70c
|
|
| BLAKE2b-256 |
cdc5eb987c030d0c01da274752747b0f77355cc20999417408db12c29b26cb22
|
Provenance
The following attestation bundles were made for lethe_memory-0.17.0-cp39-abi3-macosx_11_0_arm64.whl:
Publisher:
release-pypi.yml on teimurjan/lethe
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lethe_memory-0.17.0-cp39-abi3-macosx_11_0_arm64.whl -
Subject digest:
fe62c22cfe95861c1fe9a87837f649bf06b1c8fcc63a13f8ddb44e83116daa69 - Sigstore transparency entry: 2171994750
- Sigstore integration time:
-
Permalink:
teimurjan/lethe@7c8211e61f4cee602af80ae2fffc9703e048efb0 -
Branch / Tag:
refs/tags/lethe-v0.17.0 - Owner: https://github.com/teimurjan
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@7c8211e61f4cee602af80ae2fffc9703e048efb0 -
Trigger Event:
release
-
Statement type:
