telekinesis-datatypes 0.0.1rc1

Official core data types and serialization utilities package for the Telekinesis SDK and APIs.

Telekinesis Examples | Telekinesis Data

Telekinesis Datatypes

Telekinesis Datatypes is a core library providing canonical, strongly typed data structures for robotics and computer vision within the Telekinesis ecosystem. It includes:

• 3D data types: point clouds, meshes, transforms, and geometric primitives
• 2D data types: images, bounding boxes, masks, and pixel-space geometry
• Standardized representations for common perception and geometry formats
• Efficient serialization and deserialization for reliable data exchange

This library is used internally by the Telekinesis SDK as the foundation for data exchange across perception, planning, and learning components.

Installation

You will need to have Python 3.11 or higher set up to use the Telekinesis Datatypes Package.

Run the following command to install the Telekinesis Datatypes Package.

pip install telekinesis-datatypes

Minimal Usage Example

import numpy as np
from datatypes import datatypes

# Create Rgba32 colors for R, G, B
red = datatypes.Rgba32([255, 0, 0, 255])
green = datatypes.Rgba32([0, 255, 0, 255])
blue = datatypes.Rgba32([0, 0, 255, 255])

print(f"Red color (packed uint32): {red.rgba}")
print(f"Green color (packed uint32): {green.rgba}")
print(f"Blue color (packed uint32): {blue.rgba}")

# Use __int__() to convert to integer
red_int = int(red)

print(f"Red as int: {red_int}")
print(f"Direct comparison: int(red) == red.rgba: {red_int == red.rgba}")

Expected output:

Red color (packed uint32): 4278190335
Green color (packed uint32): 16711935
Blue color (packed uint32): 65535
Red as int: 4278190335
Direct comparison: int(red) == red.rgba: True

Resources

You can find all the information on Telekinesis SDK and the usage on Telekinesis Documentation.

We provide a large set of examples to help you learn all the available skills in the SDK. Explore other example scripts demonstrating Telekinesis SDK usage on our GitHub repositories - https://github.com/telekinesis-ai/telekinesis-examples.git.

To access the sample data visit our https://github.com/telekinesis-ai/telekinesis-data.

Support

For issues and questions:

• Create an issue in the GitHub repository Telekinesis Examples.
• Contact the Telekinesis development team.

GitHub  •  LinkedIn  •  X  •  Discord