Metadata-Version: 2.4
Name: structured-data-models-client
Version: 1.0.0
Summary: One Python client for NVIDIA's structured-data foundation model NIMs
Author: NVIDIA
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/NVIDIA/structured-data-models-client
Project-URL: Source, https://github.com/NVIDIA/structured-data-models-client
Project-URL: Issues, https://github.com/NVIDIA/structured-data-models-client/issues
Project-URL: Changelog, https://github.com/NVIDIA/structured-data-models-client/blob/main/CHANGELOG.md
Keywords: structured-data,foundation-model,tabular,relational
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
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: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: structured-data-models-api==1.0.0
Requires-Dist: structured-data-models-pql==1.0.0
Requires-Dist: pandas>=2.2.2
Requires-Dist: numpy>=1.23
Requires-Dist: requests>=2.28
Requires-Dist: urllib3>=1.26
Provides-Extra: relational
Requires-Dist: structured-data-models-relational-engine==1.0.0; extra == "relational"
Provides-Extra: sqlite
Requires-Dist: structured-data-models-connectors[sqlite]==1.0.0; extra == "sqlite"
Provides-Extra: duckdb
Requires-Dist: structured-data-models-connectors[duckdb]==1.0.0; extra == "duckdb"
Provides-Extra: snowflake
Requires-Dist: structured-data-models-connectors[snowflake]==1.0.0; extra == "snowflake"
Provides-Extra: databricks
Requires-Dist: structured-data-models-connectors[databricks]==1.0.0; extra == "databricks"
Provides-Extra: postgres
Requires-Dist: structured-data-models-connectors[postgres]==1.0.0; extra == "postgres"
Provides-Extra: lakebase
Requires-Dist: structured-data-models-connectors[lakebase]==1.0.0; extra == "lakebase"
Provides-Extra: s3
Requires-Dist: structured-data-models-connectors[s3]==1.0.0; extra == "s3"
Provides-Extra: databricks-serving
Requires-Dist: databricks-sdk<1.0,>=0.68.0; extra == "databricks-serving"
Provides-Extra: all
Requires-Dist: structured-data-models-client[databricks,duckdb,lakebase,postgres,relational,s3,snowflake,sqlite]; extra == "all"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: requests-mock; extra == "test"
Dynamic: license-file

# structured-data-models-client

One Python client for NVIDIA's structured-data foundation models. Ask a
predictive question of one table, or of a whole relational schema, without
training a model for each dataset.

```bash
pip install structured-data-models-client
```

Inference runs in a NIM, so this package downloads no weights and needs no GPU.

```python
import pandas as pd
from sdm_client import KumoTabular, Request, SDMClient

labelled = pd.DataFrame(
    {
        'age': [31.0, 44.5, 28.0, 51.0, 39.0],
        'spend': [120.0, 430.0, 90.0, 510.0, 260.0],
        'churn': [0, 1, 0, 1, 0],
    }
)
to_score = pd.DataFrame({'age': [33.0, 47.0], 'spend': [150.0, 480.0]})

request = Request(
    context=labelled, predict=to_score, target='churn', task='classification'
)

with SDMClient(url='http://localhost:8000') as client:
    print(client.predict(request, model=KumoTabular()).to_pandas())
```

The model is an argument, not a method name. For several related tables, ask in
the Predictive Query Language and pass `KumoRelational()` instead; that needs
`pip install 'structured-data-models-client[relational]'`.

Documentation, the other four packages and the examples are in the repository:
<https://github.com/NVIDIA/structured-data-models-client>

Apache-2.0. Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES.
