The MuJoCo Dexterity Suite (alpha-release)
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:
Installation
PyPI (Recommended)
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 overcomposer.Taskthat 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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| dexterity-0.0.15.tar.gz | 9.0 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.