Metadata-Version: 2.4
Name: tensorplate-python
Version: 0.1.4
Summary: First-party Python SDK for calling deployed TensorPlate detection and vision serving models.
Author: TensorPlate Contributors
License: Apache-2.0
Project-URL: Homepage, https://github.com/tensorplate/tensorplate
Project-URL: Repository, https://github.com/tensorplate/tensorplate
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: numpy
Requires-Dist: numpy>=1.22; extra == "numpy"
Provides-Extra: vision
Requires-Dist: numpy>=1.22; extra == "vision"
Requires-Dist: pillow>=9.1; extra == "vision"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Dynamic: license-file

# `sdk/python/`

`tensorplate-python` — the first-party Python SDK for calling deployed
TensorPlate detection and vision serving models over the v0.1 `/infer`
HTTP envelope.

The import package is `tensorplate`:

```python
import tensorplate
```

## Install

```bash
pip install tensorplate-python            # core client
pip install "tensorplate-python[vision]"  # + numpy & Pillow for VisionClient.detect
```

The wheel + sdist are also attached to each signed GitHub Release for
checksum-verified or air-gapped installs. See the
[SDK quickstart](../../docs/sdk/python.md#install) for that flow and the
`[numpy]` / `[vision]` extras.

## Ownership

- **Layer:** client / user space (no runtime or serving-worker code)
- **Language:** Python (3.10+)
- **Distribution:** `tensorplate-python` (PEP 621 `pyproject.toml`)
- **Import package:** `tensorplate`

## Documentation

- [Quickstart and API reference](../../docs/sdk/python.md) —
  `ServingClient`, `VisionClient`, `Detection`, tensors, and errors.
- [Detection workflow](../../docs/sdk/detection.md) — preprocessing, the
  `yolo_v8_single_output` contract, and postprocessing.
- [Endpoint resolution](../../docs/sdk/endpoint-resolution.md) — CLI-parity
  precedence and URL canonicalization.
- [Examples](../../examples/vision_detection_sdk/) — single-image and
  user-space camera samples.

## Scope

The SDK is a client-side library: it calls already-deployed models and
does not change runtime serving. In-runtime camera/video ingest, a
DeepStream sink, and a streaming session API are out of scope and are
not provided here.

## License

Apache-2.0. See [`LICENSE`](LICENSE).
