telekinesis-synapse 0.3.0

Official Telekinesis SDK for controlling and communication with industrial robot manipulators and tools.

Telekinesis Examples | Documentation

GitHub  •  LinkedIn  •  X  •  Discord

Telekinesis Synapse

Telekinesis Synapse is a python package for controlling and communication with industrial robot manipulators and tools. It provides a unified API across multiple robot and tool brands.

Installation

Telekinesis Synapse depends on telekinesis-urdfs for robot model data, which must be installed first. Follow the steps below to install both packages.

1. Create and activate a Conda environment:

   conda create -n telekinesis-synapse python=3.11
   conda activate telekinesis-synapse
   

2. Install telekinesis-urdfs (robot model data):

   cd /path/to/working/directory
   git clone --depth 1 https://github.com/telekinesis-ai/telekinesis-urdfs.git
   cd telekinesis-urdfs
   pip install .
   

   Note: telekinesis-urdfs is a large repository containing robot model data. The initial clone and wheel build are expected to take several minutes — do not interrupt the process.

3. Install Telekinesis Synapse:

   pip install telekinesis-synapse
   

Getting Started

from telekinesis.synapse.robots.manipulators import universal_robots

robot = universal_robots.UniversalRobotsUR10E()
print("Robot created successfully!")

To connect to a real robot, pass its IP address and enable remote control on the teach pendant:

robot.connect("192.168.1.100")

joint_positions = robot.get_joint_positions()
print("Joint positions:", joint_positions)

To disconnect:

robot.disconnect()

Example Usage for real robot and real tool

For all real robot and tools examples, ensure:

1. The robot/tool is powered on and connected to the same network as your machine.
   • Ethernet cable is securely connected to both robot/tool and network switch.
   • PC network IP is on the same subnet as the robot/tool (e.g., robot/tool at 192.168.1.100, PC in 192.168.1.0/24).
   • Verify connectivity: ping 192.168.1.100
2. The robot's/tool's IP address is correctly set in the example script.
3. For robot, remote control is enabled on the teach pendant.

More examples soon will be available in the Telekinesis Examples repository.

Resources

• Examples — Runnable examples for every supported robot and skill will soon be available on: Telekinesis Examples
• Documentation — Full SDK reference: Telekinesis Documentation

Support

For issues and questions:

• Create an issue in the GitHub repository.
• Contact the Telekinesis development team at [e-mail] or on Discord.

License

Proprietary — © Telekinesis. All rights reserved.