Installation on Mac OS X

Ray should work with Python 2 and Python 3. We have tested Ray on OS X 10.11 and 10.12.

You can install Ray as follows.

pip install ray

Building Ray from source

If you want to use the latest version of Ray, you can build it from source.


To build Ray, first install the following dependencies. We recommend using Anaconda.

brew update
brew install cmake pkg-config automake autoconf libtool boost wget

pip install numpy cloudpickle funcsigs click colorama psutil redis flatbuffers cython --ignore-installed six

If you are using Anaconda, you may also need to run the following.

conda install libgcc

Install Ray

Ray can be built from the repository as follows.

git clone
cd ray/python
python install  # Add --user if you see a permission denied error.

Test if the installation succeeded

To test if the installation was successful, try running some tests. This assumes that you’ve cloned the git repository.

python test/

Cleaning the source tree

The source tree can be cleaned by running

git clean -f -f -x -d

in the ray/ directory.