Metadata-Version: 2.4
Name: stringmind
Version: 0.1.0
Summary: Official Python SDK for StringMind, TOVX's scientific discovery agent
Author: TOVX
Keywords: stringmind,tovx,ai,scientific-discovery,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
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 :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# StringMind Python SDK

The official Python SDK for **StringMind**, TOVX's scientific discovery agent
for integrating quantitative methods and AI reasoning.

StringMind is currently in alpha. This first release provides a typed discovery
task model and a low-level API client. Product-specific resources will be added
as the public API evolves.

## Installation

```bash
pip install stringmind
```

## Configure the client

```bash
export STRINGMIND_BASE_URL="https://your-stringmind-api.example/v1"
export STRINGMIND_API_KEY="your-api-key"
```

```python
from stringmind import DiscoveryTask, StringMind

task = DiscoveryTask(
    objective="Identify candidate materials with high ionic conductivity",
    domain="materials-science",
    constraints={"temperature_kelvin": 298},
)

with StringMind() as client:
    result = client.post("/your-endpoint", json=task.to_dict())
    print(result)
```

You can also pass `api_key` and `base_url` directly to `StringMind`. The client
sends `Authorization: Bearer <key>` and decodes JSON responses. Non-successful
responses raise a subclass of `StringMindError`.

