Metadata-Version: 2.4
Name: tetrix-sdk
Version: 0.1.1
Summary: TetrixAIDb Python SDK — AI-native database client
Project-URL: Repository, https://github.com/deskree-inc/tetrix-ee
License-Expression: MIT
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.9; extra == 'dev'
Description-Content-Type: text/markdown

# TetrixAIDb Python SDK

Async Python client for [TetrixAIDb](https://github.com/deskree-inc/tetrix-ee), the AI-native database daemon that unifies vector, keyword, graph, and object storage behind a single binary protocol.

## Installation

```bash
pip install tetrix-aidb
```

Requires Python 3.11+.

## Quick Start

```python
import asyncio
from tetrix_aidb import ClientConfig, TetrixClient

async def main():
    client = TetrixClient(ClientConfig(
        endpoint="tcp://localhost:7779",
        username="admin",
        password="secret",
    ))
    await client.connect()

    health = await client.health()
    print(f"Status: {health.status}")

    await client.close()

asyncio.run(main())
```

## Features

- Async-first API built on `asyncio`
- TCP, TLS, and Unix socket transports
- Auth-on-connect with automatic session handling
- Entity indexing, semantic search, and batch operations
- IAM operations: organizations, users, teams, permissions
- Category management
- Typed request/response models

## License

MIT
