Metadata-Version: 2.4
Name: hierarchical-memory
Version: 1.0.1
Summary: A 4-tier hierarchical memory system for AI agents
Home-page: https://github.com/superinstance/hierarchical-memory
Author: SuperInstance
Author-email: SuperInstance <contact@superinstance.ai>
Maintainer-email: SuperInstance <contact@superinstance.ai>
License: MIT
Project-URL: Homepage, https://github.com/superinstance/hierarchical-memory
Project-URL: Documentation, https://hierarchical-memory.readthedocs.io
Project-URL: Repository, https://github.com/superinstance/hierarchical-memory
Project-URL: Bug Tracker, https://github.com/superinstance/hierarchical-memory/issues
Project-URL: Changelog, https://github.com/superinstance/hierarchical-memory/blob/main/CHANGELOG.md
Keywords: memory,ai,agent,hierarchical,cognitive,embeddings,vector-database,episodic,semantic,working-memory,cognitive-architecture
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy<2.0.0,>=1.19.0
Provides-Extra: embeddings
Requires-Dist: sentence-transformers>=2.2.0; extra == "embeddings"
Provides-Extra: chromadb
Requires-Dist: chromadb>=0.4.0; extra == "chromadb"
Provides-Extra: faiss
Requires-Dist: faiss-cpu>=1.7.0; extra == "faiss"
Provides-Extra: all
Requires-Dist: sentence-transformers>=2.2.0; extra == "all"
Requires-Dist: chromadb>=0.4.0; extra == "all"
Requires-Dist: faiss-cpu>=1.7.0; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: sphinx>=6.0.0; extra == "dev"
Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == "dev"
Requires-Dist: sphinx-autodoc-typehints>=1.23.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Hierarchical Memory

Hierarchical memory system for distributed agent fleets. Memory that organizes itself.

## Brand Line
> Trust-based memory sharing across agents with hierarchical context windows. Enables agents to share context without exposing raw data.

## Installation

```bash
pip install hierarchical-memory
```

## Usage

```python
from hierarchical_memory import HierarchicalMemory

memory = HierarchicalMemory(depth=4)
memory.store("context", {"important": "data"})
context = memory.retrieve("context")
```

## Fleet Context

Part of the Cocapn fleet. Related repos:
- **[plato-sdk](https://github.com/SuperInstance/plato-sdk)** — PLATO tile integration
- **[plato-server](https://github.com/SuperInstance/plato-server)** — Room server for knowledge
- **[iron-to-iron](https://github.com/SuperInstance/iron-to-iron)** — Git-based agent communication
- **[git-agent](https://github.com/SuperInstance/git-agent)** — Agent coordination via git

---
🦐 Cocapn fleet — lighthouse keeper architecture
