ray 2.50.1


pip install ray

  Latest version

Released: Oct 18, 2025

Project Links

Meta
Author: Ray Team
Requires Python: >=3.9

Classifiers

Programming Language
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
https://github.com/ray-project/ray/raw/master/doc/source/images/ray_header_logo.png https://readthedocs.org/projects/ray/badge/?version=master https://img.shields.io/badge/Ray-Join%20Slack-blue https://img.shields.io/badge/Discuss-Ask%20Questions-blue https://img.shields.io/twitter/follow/raydistributed.svg?style=social&logo=twitter https://img.shields.io/badge/Get_started_for_free-3C8AE9?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8%2F9hAAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAEKADAAQAAAABAAAAEAAAAAA0VXHyAAABKElEQVQ4Ea2TvWoCQRRGnWCVWChIIlikC9hpJdikSbGgaONbpAoY8gKBdAGfwkfwKQypLQ1sEGyMYhN1Pd%2B6A8PqwBZeOHt%2FvsvMnd3ZXBRFPQjBZ9K6OY8ZxF%2B0IYw9PW3qz8aY6lk92bZ%2BVqSI3oC9T7%2FyCVnrF1ngj93us%2B540sf5BrCDfw9b6jJ5lx%2FyjtGKBBXc3cnqx0INN4ImbI%2Bl%2BPnI8zWfFEr4chLLrWHCp9OO9j19Kbc91HX0zzzBO8EbLK2Iv4ZvNO3is3h6jb%2BCwO0iL8AaWqB7ILPTxq3kDypqvBuYuwswqo6wgYJbT8XxBPZ8KS1TepkFdC79TAHHce%2F7LbVioi3wEfTpmeKtPRGEeoldSP%2FOeoEftpP4BRbgXrYZefsAI%2BP9JU7ImyEAAAAASUVORK5CYII%3D

Ray is a unified framework for scaling AI and Python applications. Ray consists of a core distributed runtime and a set of AI libraries for simplifying ML compute:

https://github.com/ray-project/ray/raw/master/doc/source/images/what-is-ray-padded.svg

Learn more about Ray AI Libraries:

  • Data: Scalable Datasets for ML

  • Train: Distributed Training

  • Tune: Scalable Hyperparameter Tuning

  • RLlib: Scalable Reinforcement Learning

  • Serve: Scalable and Programmable Serving

Or more about Ray Core and its key abstractions:

  • Tasks: Stateless functions executed in the cluster.

  • Actors: Stateful worker processes created in the cluster.

  • Objects: Immutable values accessible across the cluster.

Learn more about Monitoring and Debugging:

Ray runs on any machine, cluster, cloud provider, and Kubernetes, and features a growing ecosystem of community integrations.

Install Ray with: pip install ray. For nightly wheels, see the Installation page.

Why Ray?

Today’s ML workloads are increasingly compute-intensive. As convenient as they are, single-node development environments such as your laptop cannot scale to meet these demands.

Ray is a unified way to scale Python and AI applications from a laptop to a cluster.

With Ray, you can seamlessly scale the same code from a laptop to a cluster. Ray is designed to be general-purpose, meaning that it can performantly run any kind of workload. If your application is written in Python, you can scale it with Ray, no other infrastructure required.

More Information

Older documents:

Getting Involved

Platform

Purpose

Estimated Response Time

Support Level

Discourse Forum

For discussions about development and questions about usage.

< 1 day

Community

GitHub Issues

For reporting bugs and filing feature requests.

< 2 days

Ray OSS Team

Slack

For collaborating with other Ray users.

< 2 days

Community

StackOverflow

For asking questions about how to use Ray.

3-5 days

Community

Meetup Group

For learning about Ray projects and best practices.

Monthly

Ray DevRel

Twitter

For staying up-to-date on new features.

Daily

Ray DevRel

2.50.1 Oct 18, 2025
2.50.0 Oct 10, 2025
2.49.2 Sep 19, 2025
2.49.1 Sep 03, 2025
2.49.0 Aug 26, 2025
2.48.0 Jul 18, 2025
2.47.1 Jun 17, 2025
2.47.0 Jun 11, 2025
2.46.0 May 07, 2025
2.45.0 Apr 29, 2025
2.44.1 Mar 27, 2025
2.44.0 Mar 21, 2025
2.43.0 Feb 27, 2025
2.42.1 Feb 11, 2025
2.42.0 Feb 04, 2025
2.41.0 Jan 23, 2025
2.40.0 Dec 03, 2024
2.39.0 Nov 12, 2024
2.38.0 Oct 23, 2024
2.37.0 Sep 24, 2024
2.36.1 Sep 23, 2024
2.36.0 Sep 16, 2024
2.35.0 Aug 27, 2024
2.34.0 Jul 30, 2024
2.33.0 Jul 25, 2024
2.32.0 Jul 10, 2024
2.32.0rc0 Jul 03, 2024
2.31.0 Jun 26, 2024
2.30.0 Jun 20, 2024
2.24.0 Jun 06, 2024
2.23.0 May 22, 2024
2.22.0 May 14, 2024
2.21.0 May 08, 2024
2.20.0 May 01, 2024
2.12.0 Apr 25, 2024
2.11.0 Apr 17, 2024
2.10.0 Mar 21, 2024
2.9.3 Feb 22, 2024
2.9.2 Feb 05, 2024
2.9.1 Jan 19, 2024
2.9.0 Dec 21, 2023
2.8.1 Dec 01, 2023
2.8.0 Nov 03, 2023
2.7.2 Dec 04, 2023
2.7.1 Oct 09, 2023
2.7.0 Sep 17, 2023
2.7.0rc0 Sep 02, 2023
2.6.3 Aug 15, 2023
2.6.2 Aug 03, 2023
2.6.1 Jul 24, 2023
2.6.0 Jul 21, 2023
2.5.1 Jun 21, 2023
2.5.0 Jun 08, 2023
2.4.0 Apr 25, 2023
2.3.1 Mar 25, 2023
2.3.0 Feb 24, 2023
2.3.0rc0 Feb 23, 2023
2.2.0 Dec 13, 2022
2.1.0 Nov 08, 2022
2.0.1 Oct 22, 2022
2.0.0 Aug 23, 2022
2.0.0rc1 Aug 12, 2022
2.0.0rc0 Aug 01, 2022
1.13.0 Jun 09, 2022
1.12.1 May 16, 2022
1.12.0 Apr 14, 2022
1.12.0rc1 Apr 04, 2022
1.11.1 Apr 29, 2022
1.11.0 Mar 09, 2022
1.11.0rc1 Mar 01, 2022
1.11.0rc0 Feb 15, 2022
1.10.0 Feb 04, 2022
1.10.0rc0 Jan 11, 2022
1.9.2 Jan 11, 2022
1.9.1 Dec 22, 2021
1.9.1rc0 Dec 16, 2021
1.9.0 Dec 03, 2021
1.9.0rc2 Nov 25, 2021
1.9.0rc1 Nov 20, 2021
1.8.0 Nov 02, 2021
1.7.1 Oct 22, 2021
1.7.0 Oct 07, 2021
1.7.0rc0 Sep 20, 2021
1.6.0 Aug 23, 2021
1.5.2 Aug 12, 2021
1.5.1 Jul 31, 2021
1.5.0 Jul 26, 2021
1.4.1 Jun 30, 2021
1.4.0 Jun 07, 2021
1.4.0rc2 Jun 06, 2021
1.4.0rc1 Jun 04, 2021
1.3.0 Apr 22, 2021
1.2.0 Feb 13, 2021
1.1.0 Dec 24, 2020
1.0.1.post1 Nov 19, 2020
1.0.1 Nov 10, 2020
1.0.0 Sep 30, 2020
1.0.0rc2 Sep 23, 2020
1.0.0rc1 Sep 21, 2020
1.0.0rc0 Sep 17, 2020
0.8.7 Aug 13, 2020
0.8.6 Jun 24, 2020
0.8.5 May 07, 2020
0.8.4 Apr 02, 2020
0.8.3 Mar 25, 2020
0.8.2 Feb 24, 2020
0.8.1 Jan 27, 2020
0.8.0 Dec 17, 2019
0.7.7 Dec 16, 2019
0.7.6 Oct 24, 2019
0.7.5 Sep 25, 2019
0.7.4 Sep 05, 2019
0.7.3 Aug 04, 2019
0.7.2 Jul 03, 2019
0.7.1 Jun 11, 2019
0.7.0 May 18, 2019
0.6.6 Apr 19, 2019
0.6.5 Mar 25, 2019
0.6.4 Mar 06, 2019
0.6.3 Feb 07, 2019
0.6.2 Jan 17, 2019
0.6.1 Dec 24, 2018
0.6.0 Dec 01, 2018
0.5.3 Sep 28, 2018
0.5.2 Aug 29, 2018
0.5.0 Jul 07, 2018
0.4.0 Mar 27, 2018
0.3.1 Feb 04, 2018
0.3.0 Nov 28, 2017
0.2.2 Nov 02, 2017
0.2.1 Oct 01, 2017
0.2.0 Aug 30, 2017
0.1.2 Jun 27, 2017
0.1.1 Jun 03, 2017
Extras:
Dependencies:
click (!=8.3.0,>=7.0)
filelock
jsonschema
msgpack (<2.0.0,>=1.0.0)
packaging
protobuf (>=3.20.3)
pyyaml
requests