telekinesis-synapse 0.1.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 Pinocchio for kinematics. Install it via Conda before installing the package.

1. Create and activate a Conda environment:

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

2. Install Pinocchio:

   conda install conda-forge::pinocchio -y
   

3. 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.

4. 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")

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

See LICENSE.txt for details.