kana-memory 0.0.1__tar.gz

kana_memory-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bala Mithran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kana_memory-0.0.1/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: kana-memory
+Version: 0.0.1
+Summary: Hierarchical memory for LLM agents that dreams: layered recall, offline consolidation, and a small learned System One traverser.
+Keywords: llm,agents,memory,retrieval,consolidation
+Author: Bala Mithran
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# kana
+
+Memory for LLM agents, modelled on how people remember.
+
+Storage is cheap; context is not. Kana never deletes a memory. It keeps every experience at several layers of resolution, from a one-line gist down to the raw trace, and pulls in only as much as the current step needs:
+
+- **Think with the gist first.** Recall starts at the top layer and stops as soon as that is enough.
+- **Dig when stuck.** When the agent makes no progress, recall walks down the hierarchy toward finer detail.
+- **Dream.** Offline, Kana replays what happened, consolidates episodes into abstractions and skills, adds shortcuts to memories that turned out useful, and retrains its small System One traverser on which memories actually helped.
+
+The goal is memory that gets cheaper with experience: fewer hops and fewer context tokens per task, without losing accuracy.
+
+```bash
+pip install kana-memory
+```
+
+```python
+import kana
+
+mem = kana.Memory("agent.db")
+mem.add(event)                       # stored raw, never deleted
+ctx = mem.recall(query, budget=800)  # walk layers, stop early when the gist suffices
+mem.feedback(outcome)                # did the task succeed?
+mem.dream()                          # consolidate, rewire, retrain
+```
+
+**Status:** planning. This release reserves the name; the API above is the target, not yet implemented. Part of an IIT Madras MTech thesis on adaptive memory for autonomous LLM agents.

kana_memory-0.0.1/README.md

@@ -0,0 +1,27 @@
+# kana
+
+Memory for LLM agents, modelled on how people remember.
+
+Storage is cheap; context is not. Kana never deletes a memory. It keeps every experience at several layers of resolution, from a one-line gist down to the raw trace, and pulls in only as much as the current step needs:
+
+- **Think with the gist first.** Recall starts at the top layer and stops as soon as that is enough.
+- **Dig when stuck.** When the agent makes no progress, recall walks down the hierarchy toward finer detail.
+- **Dream.** Offline, Kana replays what happened, consolidates episodes into abstractions and skills, adds shortcuts to memories that turned out useful, and retrains its small System One traverser on which memories actually helped.
+
+The goal is memory that gets cheaper with experience: fewer hops and fewer context tokens per task, without losing accuracy.
+
+```bash
+pip install kana-memory
+```
+
+```python
+import kana
+
+mem = kana.Memory("agent.db")
+mem.add(event)                       # stored raw, never deleted
+ctx = mem.recall(query, budget=800)  # walk layers, stop early when the gist suffices
+mem.feedback(outcome)                # did the task succeed?
+mem.dream()                          # consolidate, rewire, retrain
+```
+
+**Status:** planning. This release reserves the name; the API above is the target, not yet implemented. Part of an IIT Madras MTech thesis on adaptive memory for autonomous LLM agents.

kana_memory-0.0.1/pyproject.toml

@@ -0,0 +1,30 @@
+[project]
+name = "kana-memory"
+version = "0.0.1"
+description = "Hierarchical memory for LLM agents that dreams: layered recall, offline consolidation, and a small learned System One traverser."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+keywords = [
+    "llm",
+    "agents",
+    "memory",
+    "retrieval",
+    "consolidation",
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+[[project.authors]]
+name = "Bala Mithran"
+
+[build-system]
+requires = ["uv_build>=0.9.0,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "kana"

kana_memory-0.0.1/pyproject.toml.orig

@@ -0,0 +1,22 @@
+[project]
+name = "kana-memory"
+version = "0.0.1"
+description = "Hierarchical memory for LLM agents that dreams: layered recall, offline consolidation, and a small learned System One traverser."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Bala Mithran" }]
+requires-python = ">=3.10"
+keywords = ["llm", "agents", "memory", "retrieval", "consolidation"]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+[build-system]
+requires = ["uv_build>=0.9.0,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "kana"

kana_memory-0.0.1/src/kana/__init__.py

@@ -0,0 +1,3 @@
+"""Hierarchical memory for LLM agents that dreams."""
+
+__version__ = "0.0.1"