Metadata-Version: 2.4
Name: memoryx-server-sdk
Version: 1.0.3
Summary: MemoryX ServerSDK - Server-side SDK for MemoryX API
Home-page: https://github.com/t0ken-ai/MemoryX
Author: MemoryX Team
Author-email: MemoryX Team <contact@memoryx.cloud>
License: MIT
Project-URL: Homepage, https://memoryx.cloud
Project-URL: Documentation, https://docs.memoryx.cloud
Project-URL: Repository, https://github.com/t0ken-ai/MemoryX
Project-URL: Issues, https://github.com/t0ken-ai/MemoryX/issues
Keywords: memoryx,memory,sdk,api,server
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# MemoryX ServerSDK

Server-side SDK for MemoryX API operations.

## Installation

```bash
pip install memoryx-server-sdk
```

## Quick Start

```python
from memoryx_serversdk import MemoryxServerSDK

sdk = MemoryxServerSDK()

# Send memories with explicit API key
result = sdk.send_memories(
    api_key="your_api_key_here",
    memories=[
        {"content": "User prefers dark theme", "metadata": {"category": "semantic"}}
    ]
)

# Search memories
results = sdk.search(
    api_key="your_api_key_here",
    query="preferences"
)

# List memories
memories = sdk.list(
    api_key="your_api_key_here",
    limit=50
)

# Delete a memory
sdk.delete(
    api_key="your_api_key_here",
    memory_id="memory_id_here"
)
```

## Key Differences from Client SDK

| Feature | Client SDK | ServerSDK |
|---------|-----------|-----------|
| API Key Storage | Auto-saved locally | Explicit per-request |
| Registration | Auto-register | Manual via portal |
| Use Case | Single user/client | Server-side operations |

## API Reference

### MemoryxServerSDK

Main class for MemoryX server-side operations.

#### Constructor

```python
sdk = MemoryxServerSDK(api_base_url="https://memoryx.cloud/api")
```

#### Methods

| Method | Description |
|--------|-------------|
| `send_memories(api_key, memories)` | Send single or batch memories |
| `send_conversation(api_key, conversation_id, messages)` | Send conversation for extraction |
| `search(api_key, query, limit, ...)` | Search memories by semantic similarity |
| `list(api_key, limit, offset, ...)` | List memories by creation time |
| `delete(api_key, memory_id)` | Delete a memory |
| `get_task_status(api_key, task_id)` | Get async task status |
| `get_quota(api_key)` | Get quota information |
| `verify_api_key(api_key)` | Verify API key validity |

### MemoryxServerSDKError

Exception class for ServerSDK errors.

## License

MIT License - see LICENSE file for details.
