Metadata-Version: 2.4
Name: locaith-memory
Version: 0.1.0
Summary: Portable biological memory SDK for the Locaith Memory Platform.
Author: Tuấn Anh (Locaith AI)
Project-URL: Documentation, https://memory-api.locaith.com/docs
Keywords: ai,memory,llm,agent,sdk,locaith
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx<1.0,>=0.27

# locaith-memory

`locaith-memory` is the official Python SDK for the Locaith Memory Platform.

It gives developers a simple client for:

- writing fresh context into working memory
- consolidating biological memory
- importing old AI history
- retrieving prompt-ready memory context

## Install

```bash
pip install locaith-memory
```

## Quick start

```python
from locaith_memory import LocaithMemoryClient

client = LocaithMemoryClient(api_key="locaith_sk_...")

client.implant(
    user_id="user_001",
    context="I no longer write Python every day. I now focus mostly on Rust and product strategy.",
)

memory_context = client.recall(
    "What should I keep in mind when talking to this user today?",
    user_id="user_001",
)

print(memory_context)
```

## Local or on-prem override

```python
client = LocaithMemoryClient(
    api_key="locaith_sk_...",
    base_url="http://127.0.0.1:8787",
)
```

## Publish to PyPI

One-command PowerShell flow:

```powershell
.\publish_pypi.ps1
```

Build and check only:

```powershell
.\publish_pypi.ps1 -SkipUpload
```
