This is the code for the paper

Embodied Intelligence via Learning and Evolution
Agrim Gupta, Silvio Savarese, Surya Ganguli, Fei-Fei Li

The intertwined processes of learning and evolution in complex environmental niches have resulted in a remarkable diversity of morphological forms. Moreover, many aspects of animal intelligence are deeply embodied in these evolved morphologies. However, the principles governing relations between environmental complexity, evolved morphology, and the learnability of intelligent control, remain elusive, partially due to the substantial challenge of performing large-scale in silico experiments on evolution and learning. We introduce Deep Evolutionary Reinforcement Learning (DERL): a novel computational framework which can evolve diverse agent morphologies to learn challenging locomotion and manipulation tasks in complex environments using only low level egocentric sensory information. Leveraging DERL we demonstrate several relations between environmental complexity, morphological intelligence and the learnability of control.

The code consists of three main components:

1. UNIMAL Design Space: A UNIversal aniMAL morphological design space that is both highly expressive yet also enriched for useful controllable morphologies.
2. DERL: An efficient asynchronous method for parallelizing computations underlying learning and evolution across many compute nodes.
3. Evolutionary environments and evaluation tasks: A set of three evolutionary environments and eight evaluation tasks.

We provide Dockerfile for easy installation and development. If you prefer to work without docker please take a look at Dockerfile and ensure that your local system has all the necessary dependencies installed.

# Build docker container. Ensure that MuJoCo license is present: docker/mjkey.txt
./scripts/build_docker.sh
# Evolve unimals. Please change MOUNT_DIR location inside run_docker_cpu.sh
./scripts/run_docker_cpu.sh python tools/evolution.py --cfg ./configs/evo/ft_test.yml NODE_ID 0

The default parameters assume that you are running the code on 16 machines. Please ensure that each machine has a minimum of 72 CPUs. While running the script on multiple nodes you would have to ensure that NODE_ID on each machine is unique and between [0, NUM_NODES - 1].

If you have installed all dependencies in your local machine. You can visualize the environment as follows:

python tools/terrain_builder.py --cfg configs/evo/mvt.yml

If you find this code useful, please consider citing:

@article{gupta2021embodied,
  title={Embodied intelligence via learning and evolution},
  author={Gupta, Agrim and Savarese, Silvio and Ganguli, Surya and Fei-Fei, Li},
  journal={Nature communications},
  volume={12},
  number={1},
  pages={5721},
  year={2021},
  publisher={Nature Publishing Group}
}

This codebase would not have been possible without the following amazing open source codebases:

1. ikostrikov/pytorch-a2c-ppo-acktr-gail
2. hill-a/stable-baselines
3. deepmind/dm_control
4. openai/multi-agent-emergence-environments