fix: pin click<8.2 to unbreak ray CLIPatch 1

[XiangyiWang2]

Problem

A fresh install per requirements_torch280_vllm.txt leaves the ray CLI completely broken — every ray command fails at import time:

ValueError: <object object at 0x7fa70eca36e0> is not a valid Sentinel

requirements_common.txt pins ray==2.48.0 but leaves click unconstrained, so pip resolves click 8.4.x. Ray 2.48's CLI calls copy.deepcopy() on click command objects at module import time (add_command_alias in ray/scripts/scripts.py), which fails on click>=8.2 where Sentinel became an enum — enum.__new__ rejects the dynamically created sentinel object during reconstruction.

Repro

Fresh conda env (Python 3.10.20), install per requirements_torch280_vllm.txt, then run any ray command, e.g. ray start --head.

Full traceback

Traceback (most recent call last):
  File "/root/.miniconda3/envs/roll/bin/ray", line 3, in <module>
    from ray.scripts.scripts import main
  File "/root/.miniconda3/envs/roll/lib/python3.10/site-packages/ray/scripts/scripts.py", line 2681, in <module>
    add_command_alias(up, name="create_or_update", hidden=True)
  File "/root/.miniconda3/envs/roll/lib/python3.10/site-packages/ray/scripts/scripts.py", line 2671, in add_command_alias
    new_command = copy.deepcopy(command)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 172, in deepcopy
    y = _reconstruct(x, memo, *rv)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 271, in _reconstruct
    state = deepcopy(state, memo)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 146, in deepcopy
    y = copier(x, memo)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 231, in _deepcopy_dict
    y[deepcopy(key, memo)] = deepcopy(value, memo)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 146, in deepcopy
    y = copier(x, memo)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 206, in _deepcopy_list
    append(deepcopy(a, memo))
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 172, in deepcopy
    y = _reconstruct(x, memo, *rv)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 271, in _reconstruct
    state = deepcopy(state, memo)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 146, in deepcopy
    y = copier(x, memo)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 231, in _deepcopy_dict
    y[deepcopy(key, memo)] = deepcopy(value, memo)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 172, in deepcopy
    y = _reconstruct(x, memo, *rv)
  File "/root/.miniconda3/envs/roll/lib/python3.10/copy.py", line 265, in _reconstruct
    y = func(*args)
  File "/root/.miniconda3/envs/roll/lib/python3.10/enum.py", line 385, in __call__
    return cls.__new__(cls, value)
  File "/root/.miniconda3/envs/roll/lib/python3.10/enum.py", line 710, in __new__
    raise ve_exc
ValueError: <object object at 0x7fa70eca36e0> is not a valid Sentinel

Fix

Pin click<8.2 in requirements_common.txt, right below the ray pin it belongs to.

Verified with click 8.1.8 on the same env — ray start --head and ray status both work again.

Note

This is a workaround for an upstream ray/click incompatibility; the pin can be removed once ray supports click>=8.2. The env dump in #379 shows click 8.2.1, already past the breaking version.

[CLAassistant]

All committers have signed the CLA.

[HuangJoJo]

click>=8.0,<8.2

[XiangyiWang2]

I have complete signing，Thank you！ 获取 Outlook for iOS<https://aka.ms/o0ukef>

…

________________________________ 发件人: CLAassistant ***@***.***> 发送时间: Saturday, 01 August 2026 10:46:25 收件人: alibaba/ROLL ***@***.***> 抄送: Xiangyi Wang (SDS,123090576) ***@***.***>; Author ***@***.***> 主题: Re: [alibaba/ROLL] fix: pin click<8.2 to unbreak ray CLIPatch 1 (PR #477) You don't often get email from ***@***.*** Learn why this is important<https://aka.ms/LearnAboutSenderIdentification> [https://avatars.githubusercontent.com/u/11571300?s=20&v=4]CLAassistant left a comment (alibaba/ROLL#477)<#477 (comment)> [CLA assistant check]<https://cla-assistant.io/alibaba/ROLL?pullRequest=477> Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement<https://cla-assistant.io/alibaba/ROLL?pullRequest=477> before we can accept your contribution. You have signed the CLA already but the status is still pending? Let us recheck<https://cla-assistant.io/check/alibaba/ROLL?pullRequest=477> it. ― Reply to this email directly, view it on GitHub<#477?email_source=notifications&email_token=BJAPZUKB6WRXVDBZA267WEL5HVKYDA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMJUHEZTONJYGEZ2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#issuecomment-5149375813>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/BJAPZULHN4PLGJPGZYRIL6T5HVKYDAVCNFSNUABFKJSXA33TNF2G64TZHM4TSMJZGM4TANBZHNEXG43VMU5TKMBTGQ4DONJRGUY2C5QC>. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS<https://github.com/notifications/mobile/ios/BJAPZUMZERNZQEYQFDV5QT35HVKYDA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMJUHEZTONJYGEZ2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android<https://github.com/notifications/mobile/android/BJAPZUI6GCQZMUZCH5WOS5D5HVKYDA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMJUHEZTONJYGEZ2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because you authored the thread.Message ID: ***@***.***>