Software and tasks for dexterous multi-fingered hand manipulation, powered by MuJoCo
Project description
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.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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dexterity-0.0.15-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a34bfce9787d07fee62d51c025841579a08a31852f5d4210f33d7ec286452878 |
|
MD5 | 19a8b4ef0dbd3dd38ea14d59f06e5777 |
|
BLAKE2b-256 | cc51e4ab14a4e62b52dc098a42a5da2f37ada8b97ee17fabdad836502dfcd32d |