README.md

Anti-Poaching Environment (APE)

This is the repository for APE, the Anti-Poaching Environment. This is a mixed, zero-sum and multi-agent game between independent poachers and cooperative rangers on a grid. The main implementation can be found at anti_poaching.py, where it is implemented as a PettingZoo environment. Examples that use this environment are found in the (examples)(examples/) directory. Notably, this includes the RLlib (currently supported at v2.8.0) interface in the rllib folder.

Installation

To have a ready-to-go environment created for you, use virtualenv (or similar tools of your choice) to create a python virtual environment. We currently test with python3.8, but later versions should also work.

$ virtualenv -p python3.8 ape; 
$ source ape/bin/activate;

To install the environment with a GPU-enabled version of pytorch enabled, you can supply the full option as follows from the root directory of this project. This will install the environment as an editable package using pip.

$ pip  install -e .[code,gpu] # For GPU-enabled torch

Alternatively, to install only the CPU version of PyTorch, use

$ pip  install -e .[code,cpu] # For CPU-only torch