Metadata-Version: 2.4
Name: hx-sdk
Version: 0.1.3
Summary: HexelStudio Python SDK
Project-URL: Homepage, https://hexelstudio.com
Project-URL: Documentation, https://docs.hexelstudio.com/sdk/python
Project-URL: Repository, https://github.com/hexelstudio/hx-python
Author-email: HexelStudio <support@hexelstudio.com>
License-Expression: MIT
Keywords: ai,hexelstudio,hx,knowledge,memory,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Requires-Python: >=3.9
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: responses>=0.23.0; extra == 'dev'
Description-Content-Type: text/markdown

# HX SDK

Python SDK for HexelStudio.

## Installation

```bash
pip install hx-sdk
```

## Configuration

Just set your API key — org, workspace, and environment are automatically extracted from the token:

```bash
export HX_API_KEY="your-api-key"
```

Optionally override the base URL:
```bash
export HX_BASE_URL="https://api.hexelstudio.com"  # default
```

## Usage

```python
from hx import Client

client = Client()

# Knowledge search
results = client.knowledge.search("ks_support", "refund policy")

# Memory operations
client.memory.add(
    "ms_support",
    messages=[
        {"role": "user", "content": "I prefer email"},
        {"role": "assistant", "content": "Noted!"}
    ],
    user_id="user_123"
)

memories = client.memory.search("ms_support", "preferences", user_id="user_123")

# Access tenant info from token (if needed)
print(client.org_id)
print(client.workspace_id)
print(client.environment_id)
```

## Documentation

See [docs.hexelstudio.com](https://docs.hexelstudio.com/sdk/python) for full API reference.
