Metadata-Version: 2.4
Name: statelet
Version: 0.1.2
Summary: Statelet server binaries — agent memory with KV, vector search, and temporal causal graphs in one database
License-Expression: Apache-2.0
Project-URL: Homepage, https://statelet.com
Project-URL: Repository, https://github.com/stateletlab/statelet
Keywords: statelet,agent,memory,vector,graph,database,llm,ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: statelet-sdk>=0.1.1

# statelet

Server binaries for [Statelet](https://github.com/stateletlab/statelet) — agent
memory with KV, vector search, and temporal causal graphs in one database.

```bash
pip install statelet
```

Then bring a local cluster up:

```bash
statelet-cluster start          # --nodes N, default 3
statelet-cluster status
statelet-cluster stop           # --clean also deletes the data directory
```

```python
from statelet import Client
c = Client("127.0.0.1:9379", username="admin", password="admin")
c.put(b"hello", b"world")
print(c.get(b"hello"))          # b'world'
```

Data and logs live under `~/.statelet/cluster`, or `$STATELET_DATA_DIR`.

The individual executables are on your `PATH` too, for anyone driving them
under systemd, Docker or a supervisor of their own —

| Command | Role |
|---|---|
| `statelet-gateway` | stateless routing gateway; what clients connect to |
| `statelet-metadata` | metadata-plane Raft group |
| `statelet-datanode` | data-plane storage engine |

— and pulls in `statelet-sdk`, so `import statelet` works in the same
environment.

Platform wheels are published for macOS (Apple Silicon and Intel), Linux
(x86_64 and aarch64, glibc 2.17 and newer), and Windows x64. Anywhere else,
build from a checkout.

Licensed under Apache-2.0.
