Ray

.. image:: https://travis-ci.com/ray-project/ray.svg?branch=master
:target: https://travis-ci.com/ray-project/ray

.. image:: https://readthedocs.org/projects/ray/badge/?version=latest
:target: http://ray.readthedocs.io/en/latest/?badge=latest

|

Ray is a flexible, high-performance distributed execution framework.

Ray is easy to install: pip install ray

Example Use

+------------------------------------------------+----------------------------------------------------+
| Basic Python | Distributed with Ray |
+------------------------------------------------+----------------------------------------------------+
|.. code-block:: python |.. code-block:: python |
| | |
| # Execute f serially. | # Execute f in parallel. |
| | |
| | @ray.remote |
| def f(): | def f(): |
| time.sleep(1) | time.sleep(1) |
| return 1 | return 1 |
| | |
| | |
| | ray.init() |
| results = [f() for i in range(4)] | results = ray.get([f.remote() for i in range(4)]) |
+------------------------------------------------+----------------------------------------------------+

Ray comes with libraries that accelerate deep learning and reinforcement learning development:

• Ray Tune_: Hyperparameter Optimization Framework
• Ray RLlib_: Scalable Reinforcement Learning

.. _Ray Tune: http://ray.readthedocs.io/en/latest/tune.html
.. _Ray RLlib: http://ray.readthedocs.io/en/latest/rllib.html

Installation

Ray can be installed on Linux and Mac with pip install ray.

To build Ray from source or to install the nightly versions, see the installation documentation_.

.. _installation documentation: http://ray.readthedocs.io/en/latest/installation.html

More Information

• Documentation_
• Tutorial_
• Blog_
• Ray paper_
• Ray HotOS paper_

.. _Documentation: http://ray.readthedocs.io/en/latest/index.html
.. _Tutorial: https://github.com/ray-project/tutorial
.. _Blog: https://ray-project.github.io/
.. _Ray paper: https://arxiv.org/abs/1712.05889
.. _Ray HotOS paper: https://arxiv.org/abs/1703.03924

Getting Involved

• Ask questions on our mailing list ray-dev@googlegroups.com_.
• Please report bugs by submitting a GitHub issue_.
• Submit contributions using pull requests_.

.. _ray-dev@googlegroups.com: https://groups.google.com/forum/#!forum/ray-dev
.. _GitHub issue: https://github.com/ray-project/ray/issues
.. _pull requests: https://github.com/ray-project/ray/pulls