Skip to content

omarrayyann/TeleDex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

171 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo  Teledex

PyPI version Downloads License: MIT

teledex lets you control robot frames and hands using your iOS device's AR data.

Oranges Reactive Coffee Handover Batteries Wipes Notes Precise manipulation

Installation

You can install teledex package using pip:

pip install teledex

You can download the app from the App Store.

Before You Get Started

You can use Teledex in phone-only mode (streams only the device pose) or with an optional 3D-printed holder to track finger motion while teleoperating. All printable parts are available in printables folder.

See ASSEMBLY_GUIDE for assembly notes and SETUP_GUIDE to get started with your phone and robot setup.

Basic Usage

Basic Setup

import teledex

session = teledex.Session()
session.start()

# Retrieve AR data
data = session.get_latest_data()
# Returns: {"position": (3,), "rotation": (3, 3), "button": bool, "button_secondary": bool, # "toggle": bool}

MuJoCo Setup

Control MuJoCo frames (body, geom, or site) with Teledex:

import teledex

session = teledex.Session()

mujoco_handler = teledex.MujocoHandler(model=my_model, data=my_data)
session.add_handler(mujoco_handler)

mujoco_handler.link_body(name="eef_target")

session.start()

Additional Functions

session.vibrate(sharpness=0.8, intensity=0.4, duration=0.01)
session.pause_updates()
session.resume_updates()
session.reset_position()

Citation

If you use Teledex in your research, please cite:

@article{rayyan2026teledex,
  title={TeleDex: Accessible Dexterous Teleoperation},
  author={Rayyan, Omar and Gilles, Maximilian and Cui, Yuchen},
  journal={arXiv preprint arXiv:2603.17065},
  year={2026}
}

About

phone teleoperation for robots

Resources

Stars

117 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors

Languages