Skip to main content

The MuJoCo Dexterity Suite (alpha-release)

PyPI Python Version PyPI version dexterity-tests

Software and tasks for dexterous multi-fingered hand manipulation, powered by MuJoCo.

dexterity builds on dm_control and provides a collection of modular components that can be used to define rich Reinforcement Learning environments for dexterous manipulation. It also comes with a set of standardized tasks that can serve as a performance benchmark for the research community.

An introductory tutorial is available as a Colab notebook: Open In Colab

Installation

The recommended way to install this package is via PyPI:

pip install dexterity

Source

We provide a Miniconda environment with Python 3.8 for development. To create it and install dependencies, run the following steps:

git clone https://github.com/kevinzakka/dexterity
cd dexterity
conda env create -f environment.yml  # Creates a dexterity env.
conda activate dexterity
pip install .

Overview

The MuJoCo dexterity suite is composed of the following core components:

  • models: MuJoCo models for dexterous hands and PyMJCF classes for dynamically customizing them.
  • inverse_kinematics: Inverse kinematics library for multi-fingered hands.
  • effectors: Interfaces for controlling hands and defining action spaces.

These components, in conjunction with dm_control, allow you to define and customize rich environments for reinforcement learning. We facilitate this process by providing the following:

  • task: Wrappers over composer.Task that simplify the creation of generic dexterous tasks as well as goal-reaching based tasks (e.g., successive object reorientation).
  • manipulation: A library of pre-defined, benchmark RL environments geared towards dexterous manipulation. For an overview of the available tasks, see the task library.

Our hope is to grow the benchmark over time with crowd-sourced contributions from the research community -- PR contributions are welcome!

Acknowledgements

A large part of the design and implementation of dexterity is inspired by the MoMa library in dm_robotics.

Metadata

Release files for dexterity 0.0.15

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

Source distribution (sdist)

Source distribution for dexterity 0.0.15
File Size Uploaded Provenance
dexterity-0.0.15.tar.gz 9.0 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for dexterity 0.0.15
File Interpreter ABI Platform
dexterity-0.0.15-py3-none-any.whl Python 3 none any Details

Total release size: 18.1 MB

Release files / dexterity-0.0.15.tar.gz

Download URL dexterity-0.0.15.tar.gz
Size 9.0 MB
Tags Source
SHA-256 checksum
How to use checksums
b27d6af0771625e52e84b5ea7d3b1b86100ebb57d6f9460eef198b928b1362ee
BLAKE2b-256 checksum
How to use checksums
10f28a4034b5b5c1718bd76114163f11daf8c4761a0e7cd27c3a30c4c1a55195
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.9.12

Release files / dexterity-0.0.15-py3-none-any.whl

Download URL dexterity-0.0.15-py3-none-any.whl
Size 9.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a34bfce9787d07fee62d51c025841579a08a31852f5d4210f33d7ec286452878
BLAKE2b-256 checksum
How to use checksums
cc51e4ab14a4e62b52dc098a42a5da2f37ada8b97ee17fabdad836502dfcd32d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.9.12

Security for dexterity 0.0.15

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

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