Metadata-Version: 2.4
Name: griip-sdk
Version: 0.1.0
Summary: GRIIP SDK: hardware control and orchestration for bin picking
License: Proprietary
Keywords: Vention,GRIIP,SDK,Robot,Gripper,Automation
Author: VentionCo
Requires-Python: >=3.10,<3.11
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: defusedxml (>=0.7.1,<0.8.0)
Requires-Dist: grpcio (>=1.78.0)
Requires-Dist: httpx (>=0.28.1,<0.29.0)
Requires-Dist: numpy (>=1.24)
Requires-Dist: omegaconf (>=2.3.0,<3.0.0)
Requires-Dist: opencv-python-headless (>=4.9.0,<5.0.0)
Requires-Dist: paho-mqtt (>=2.1.0,<3.0.0)
Requires-Dist: protobuf (>=4.0)
Requires-Dist: pydantic (>=2.12.5,<3.0.0)
Requires-Dist: pymodbus (>=3.12.1,<4.0.0)
Requires-Dist: scipy (>=1.11.0,<2.0)
Requires-Dist: spatialmath-python (>=1.1.15,<2.0.0)
Requires-Dist: toppra (>=0.6.0)
Requires-Dist: trimesh (>=4.11,<5.0)
Requires-Dist: urchin (>=0.0.30,<0.0.31)
Requires-Dist: vention-firmware-grpc-client (>=1.0.0)
Description-Content-Type: text/markdown

# griip-sdk

Python SDK for hardware control and orchestration of gripper-based bin picking on Vention's MachineMotion platform.

## Installation

```bash
pip install griip-sdk
```

## Prerequisites for hardware control

`griip-sdk` depends on two private wheels that are not on PyPI. Install them manually from GitHub Releases before using hardware features:

```bash
# vamp_planner
pip install "https://github.com/VentionCo/platform-products/releases/download/vamp-wheel-v0.6.1-20260313/vamp_planner-<version>-cp310-cp310-linux_aarch64.whl"

# foundationstereoclient
pip install "https://github.com/VentionCo/platform-products/releases/download/foundationstereoclient/v1.11.0/foundationstereoclient-<version>-cp310-cp310-linux_aarch64.whl"
```

> These manual steps are temporary. Both packages will eventually become MachineMotion-side services, at which point this step goes away.

## Quickstart

```python
from griip_sdk import BaseGripper, GripperMoveResult, Robotiq2F140Gripper

gripper = Robotiq2F140Gripper(host="<machineMotion-ip>")
result: GripperMoveResult = gripper.move(position=0.5)
```

## What's NOT shipped on PyPI

The demo runners under `griip_sdk.prototyping.run_*` import `mmai_griip_api` (the gRPC service). They are not part of the public API and will fail to import unless `mmai-griip-api` is installed alongside the SDK (e.g. via the Debian package on a MachineMotion).

## Releases

Versioning is hand-bumped semver. Bump `version` in `pyproject.toml` before triggering the PyPI publish workflow (`publish-griip-sdk-pypi.yml`).

