you can install the newest version via

pip install gym-fetch

Alternatively, you can clone this repo and install under development mode:

git clone <this repo>
cd <this repo>
pip install -e .

For those who do not use pip, you can pull/checkout specific versions of the repository using a git tag. Github integrates with git, such that it shows tagged versions under the <project-repo>/releases URL. You can check out the releases for this repo at https://github.com/geyang/gym-fetch/releases. To pull a specific version, just run:

git checkout v0.1.0-rc5

After git clone, the structure of the project is

$ tree . -L 1
gym-fetch
├── fetch
└── specs

To install, you can use pip

pip install -e .

Alternatively, you can include the ./gym-fetch directory as part of your PYTHONPATH.

• Box

We extend existing Fetch environments from gym, with 7 new manipulation tasks. The gym.Fetch environment are much better engineered than the sawyer environments that metaworld uses. They are faster to initialize, and have a small (50 step) maximum episode length, making these environments faster to train on.

We might or might not need to extend the max_episode_steps on more complex tasks.

Reach-v2	Push-v2	PickPlace-v2	Slide-v2

All documentations are maintained in the ./specs folder, where each task set is one markdown file.

• original gym fetch tasks: ./specs/gym_fetch.md
• bin tasks: ./specs/bin.md
• bin_debug tasks: ./specs/bin_debug.md
• box tasks: ./specs/box.md
• drawer tasks: ./specs/drawer.md

The multi-task environments are still under development. They are located under

 fetch
 ├── tasksets
     ├── box_block.md
     ├── box_block.py

The tasks involve a single primitive action such as open/closing a box, or a drawer. They do not additionally involve placing an object into the opened drawer or box. We include bin picking and placing because the bin does not require additional actions to open.

Box-open-v0	Box-close-v0	Bin-pick-v0	Bin-place-v0
Drawer-open-v0	Drawer-close-v0

These tasks additionally require placing the object inside an open drawer or box. We include the Bin-picking environment for completeness.

Bin-pick-v0	Bin-place-v0	Box-pick-v0	Box-place-v0
Drawer-pick-v0	**Drawer-place-v0 **

These environments require significantly more memory due to the increasing complexity of contact detection and collision dynamics. These are also slower to run.

BoxBin-v0	DrawerBin-v0	BoxBinDrawer-v0