Skip to main content

TeleMoMa: A Modular and Versatile Teleoperation System for Mobile Manipulation

Shivin Dass1, Wensi Ai2, Yuqian Jiang1, Samik Singh1, Jiaheng Hu2, Ruohan Zhang1, Peter Stone1,3, Ben Abbatematteo1, Roberto Martín-Martín1

1The University of Texas at Austin, 2Stanford University, 3Sony AI

[Paper], [Project Website]

TeleMoMa is a teleoperation toolkit that enables intuitive teleoperation of high-DoF mobile manipulators. We provide a common pipeline that supports several teleoperation interfaces such as vision, VR, mobile phones and more, and enables mixing-and-matching between them. While we provide code for several mobile manipulators in sim and real, the versatility of TeleMoMa allows easy plug-and-play teleoperation of any mobile manipulator in general.

Setup

System Requirements

  • Ubuntu 20.04
  • Python 3.9+

Other system configurations may work, but we haven’t tested them extensively and may only be able to provide limited support.

Note: TeleMoMa can work with higher versions of python but if iGibson sim environment is required then please use python3.9.

Installation

git clone https://github.com/UT-Austin-RobIn/telemoma.git
cd telemoma
conda create --name telemoma python==3.9
conda activate telemoma
pip install -e .

Install iGibson (Optional)

We provide a demo script to test different teleoperation modes in the iGibson sim environment. iGibson can be installed by running,

(telemoma) > pip install igibson

In case of installation or runtime issues with iGibson, please checkout their exhaustive documentation and github.

Usage

Quickstart

To verify your installation the following code can be used to run TeleMoMa in a sandbox environment in iGibson.

(telemoma) > python telemoma/demo_igibson.py --robot tiago --teleop_config telemoma/configs/only_keyboard.py 

--teleop_config defines the input modality to be used for controlling each part of the robot. Some example configurations are provided in telemoma/configs folder.

Make sure the input hardware is correctly setup by following the instructions provided in Human Interface.

Human Interface

Hardware specific setup instructions for devices compatible with TeleMoMa are provided here.

Robot Interface

The details on the sim environment installations, real robot codebase and instructions on setting up TeleMoMa on your own robot are provided here.

Citation

@article{dass2024telemoma,
  title={TeleMoMa: A Modular and Versatile Teleoperation System for Mobile Manipulation},
  author={Dass, Shivin and Ai, Wensi and Jiang, Yuqian and Singh, Samik and Hu, Jiaheng and Zhang, Ruohan and Stone, Peter and Abbatematteo, Ben and Martín-Martín, Roberto},
  journal={arXiv preprint arXiv:2403.07869},
  year={2024}
}

Acknowledgements: Mentioned here

Metadata

Release files for telemoma 0.3.0

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

Source distribution (sdist)

Source distribution for telemoma 0.3.0
File Size Uploaded
telemoma-0.3.0.tar.gz 831.9 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for telemoma 0.3.0
File Interpreter ABI Platform
telemoma-0.3.0-py3-none-any.whl Python 3 none any Details
telemoma-0.3.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 883.0 kB

Release files / telemoma-0.3.0.tar.gz

Download URL telemoma-0.3.0.tar.gz
Size 831.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2dc02ea472d04327d0f8db752c9e5cf9cbc496e6cb399d16ec55f657e7c46ba7
BLAKE2b-256 checksum
How to use checksums
15a5a859d687ec452f21840222a36625dba20efdbd0e4b5826b9fda9700f87c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.18

Release files / telemoma-0.3.0-py3-none-any.whl

Download URL telemoma-0.3.0-py3-none-any.whl
Size 25.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1d30b518e0cb0ecc19d312e0682082f037a1bc5e4f5032e352689871dc61b94a
BLAKE2b-256 checksum
How to use checksums
4ef5331f77dfe6947cd28d2927cb57da737c91098f42f3a82b07252b616c50e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.23

Release files / telemoma-0.3.0-py2.py3-none-any.whl

Download URL telemoma-0.3.0-py2.py3-none-any.whl
Size 26.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
1517d951c9b256e230ec929723570d2e184f75d8f5d907a1f52cf2375b2627a1
BLAKE2b-256 checksum
How to use checksums
3af14a56b2cdd744662a1243617d66d197ea4d1ad40b5974c8face246b92bfd1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.18

Release history Release notifications | RSS feed

This release

0.3.0 This release

3 release files

0.2.0

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page