GitHub • LinkedIn • X • Discord

Telekinesis Datatypes

Telekinesis Datatypes is a core library providing canonical, strongly typed data structures for robotics and computer vision applications 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

Release Model

Telekinesis Datatypes is currently in active development (pre-1.0). Modules are introduced incrementally, and the API may evolve between minor releases. To ensure compatibility and access to the latest capabilities, always install or upgrade to the most recent version of the package.

Installation

Create an isolated environment so that there is no dependency conflicts. We recommend installing Miniconda environment by following instructions from here.
Create a new conda environment called telekinesis-datatypes:

We currently support Python versions - 3.11, 3.12. Ensure your environment is in the specified Python version.
```
conda create -n telekinesis-datatypes python=3.11
```
Activate the environment:
```
conda activate telekinesis-datatypes
```
Install the core package using pip:
```
pip install telekinesis-datatypes
```
Note: The Python module is called datatypes, while the package published on PyPI is telekinesis-datatypes.

Example

Run a sample python code to quickly test your installation.

import rerun as rr
from telekinesis import datatypes

url = "https://assets.telekinesis.ai/examples/v1/images/screws_standing.jpg"
image_from_url = datatypes.Image.from_url(url)

rr.init("datatypes_examples", spawn=True)
datatypes.visualize(image_from_url, entity_path="/ImageFromURL")

You are now set up with Telekinesis Datatypes.

Resources

All module examples are available in Telekinesis Examples
Full SDK documentation and usage details: Telekinesis Documentation

Support

For issues and questions:

Create an issue in the GitHub repository.
Contact the Telekinesis development team at support@telekinesis.ai or on Discord.

Metadata

Release files for telekinesis-datatypes 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for telekinesis-datatypes 0.4.1
File	Size	Uploaded
telekinesis_datatypes-0.4.1.tar.gz	233.7 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for telekinesis-datatypes 0.4.1
File	Interpreter	ABI	Platform	Reset
telekinesis_datatypes-0.4.1-py3-none-any.whl 243.0 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 476.7 kB

Release files / telekinesis_datatypes-0.4.1.tar.gz

Download URL	telekinesis_datatypes-0.4.1.tar.gz
Size	233.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`34a695404d8f46715942dcc7f92f85c06a10f2bb6df5c6bd92861278c32bf836`
BLAKE2b-256 checksum How to use checksums	`fd8331c519c2a3bb4c4894927fe116ffecf624e04cc7b8fc9e462f33ef19de6e`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.11.15`

Release files / telekinesis_datatypes-0.4.1-py3-none-any.whl

Download URL	telekinesis_datatypes-0.4.1-py3-none-any.whl
Size	243.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`48828bd5fa72486bc0daa4af00711053bdfa99c1a77d6e64136ddd0cb78da220`
BLAKE2b-256 checksum How to use checksums	`4df49133dec2356c966f78e2f3532c19ea3b011dfebef41f6027e8c9db21274b`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.11.15`