Telekinesis Agentic Skill Library

Appearance

Release (Suction Gripper) ​

SUMMARY

Release stops vacuum generation on a suction gripper to drop the currently grasped object.

This skill is used to deposit an object once the gripper is positioned at the place location.

SUPPORTED GRIPPERS

Available on Piab suction grippers.

The Skill ​

python
gripper.release()

The Code ​

Example: Grasp Then Release ​

python
"""
Piab release example for the Synapse SDK.

Connects to a Piab piCOBOT Electric gripper, grasps, holds briefly,
then releases.

Usage:
    python release.py --ip <ROBOT_IP>
"""

import time
import argparse
from loguru import logger

from telekinesis.synapse.tools.suction_grippers import piab


def main(ip: str):
    """Grasp, hold, then release."""

    # Create and connect to the gripper
    gripper = piab.PiabPiCobotElectric()
    gripper.connect(ip=ip, protocol="URCAP")

    try:
        gripper.grasp()
        time.sleep(1.0)
        gripper.release()
        logger.success("Released.")
    finally:
        gripper.disconnect()


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="Piab gripper release example")
    parser.add_argument("--ip", type=str, required=True, help="UR controller IP address")
    args = parser.parse_args()

    main(ip=args.ip)

The Explanation of the Code ​

release stops vacuum generation immediately, dropping any grasped object. It takes no parameters - the vacuum level configured via grasp or set_vacuum_level is preserved for the next grasp call.

How to Tune the Parameters ​

No parameters.

Where to Use the Skill ​

  • Place operations - Release after positioning the object at its destination
  • Fault recovery - Release to drop an object cleanly before retrying a failed pick

When Not to Use the Skill ​

Do not use Release when:

  • The gripper is not connected - always call connect before issuing commands
  • The object is not yet positioned - releasing mid-transit drops the object uncontrolled