Metadata-Version: 2.4
Name: memside
Version: 0.2.0
Summary: Python client for Memside AI continuity, portable context, checkpoints, operating rules, User AI Profile, and AI Skills.
Author-email: Memside <support@memside.com>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://github.com/memside/memside
Project-URL: Repository, https://github.com/memside/memside
Project-URL: Issues, https://github.com/memside/memside/issues
Keywords: memside,ai,memory,mcp,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.md
Dynamic: license-file

# Memside Python SDK

Python client for Memside AI continuity, portable context, checkpoints, operating rules, User AI Profile, and AI Skills.

## Install

```bash
pip install memside
```

## Usage

```python
from memside import MemsideClient

client = MemsideClient(api_key="mem_sk_your_key_here")

startup = client.context_startup()
print(startup)
```

Create a memory with the public `type` and `text` fields:

```python
memory = client.memories_create(
    {
        "type": "note",
        "text": "Packing checklist\nBring a charger and a reusable bottle.",
        "sensitivity": "private",
    }
)
```

Deletion requires the resource-specific confirmation returned by your
application workflow:

```python
client.memories_delete(
    memory["id"],
    f"CONFIRM_DELETE_{memory['id']}",
)
```

You can also set the API key through the environment:

```bash
MEMSIDE_API_KEY=mem_sk_your_key_here
```

## Supported API Areas

This package wraps public Memside API-key routes:

- startup context
- resume context
- workspace profile
- memory listing
- memory search
- memory fetch
- bounded exact-ID memory batch reads
- memory create
- memory update
- memory delete, when allowed by the API

This package does not include private Memside application source, account/session internals, billing internals, admin routes, database details, or MCP server implementation.

Public request and response shapes are exported as lightweight `TypedDict`
definitions for editors and type checkers. Failed requests raise
`MemsideError`, including `status`, `code`, `retryable`, `retry_after`,
`request_id`, and safe `details`.

## Requirements

Python 3.9 or newer.
