Metadata-Version: 2.4
Name: tovx
Version: 0.1.0
Summary: Official Python SDK for TOVX AI
Project-URL: Homepage, https://tovx.ai
Keywords: tovx,ai,sdk
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.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
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# TOVX AI Python SDK

The official Python entry point for TOVX AI.

> The SDK is currently in alpha. Its low-level client is stable enough to use
> while product-specific resources are being added.

## Installation

```bash
pip install tovx
```

## Quick start

Set the API endpoint and API key in the environment:

```bash
export TOVX_BASE_URL="https://your-tovx-api.example/v1"
export TOVX_API_KEY="your-api-key"
```

Then make a JSON request:

```python
from tovx import Tovx

with Tovx() as client:
    result = client.get("/models")
    print(result)
```

You can also configure the client directly:

```python
from tovx import Tovx

client = Tovx(
    api_key="your-api-key",
    base_url="https://your-tovx-api.example/v1",
    timeout=30,
)

result = client.post("/jobs", json={"input": "Hello from TOVX"})
```

The client sends `Authorization: Bearer <key>` and accepts JSON responses.
Non-successful responses raise a subclass of `TovxError`.

