Skip to content
This repository was archived by the owner on Sep 18, 2025. It is now read-only.

Conversation

@pentschev
Copy link
Member

This is expected to be the last commit to UCX-Py. It updates the README and docs warnings to inform users that UCX-Py has been permanently discontinued. Along with it, this change removes CUDA 13 mentions from docs, since there will be no CUDA 13 packages released for UCX-Py, however, the functional changes to allow building with CUDA 13 are kept should those be needed for any reason in the near-term.

@pentschev pentschev requested a review from jameslamb September 17, 2025 17:01
@pentschev pentschev self-assigned this Sep 17, 2025
@pentschev pentschev added improvement breaking Breaking change labels Sep 17, 2025
Copy link
Member

@jameslamb jameslamb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If I've understood the plan correctly, I think we also need to update the version here:

# The full version, including alpha/beta/rc tags.
from ucp import __version__ as release
# The short X.Y version.
version = ".".join(release.split(".")[:2])

To a hard-coded:

version = "0.45.0"

Otherwise, when we merge this branch to main and build docs from there, the docs will say 0.46.0 for the version wherever Sphinx puts it, like in the tab titles:

image

pip install 'libucx-cu13>=1.19.0,<1.20'

# CUDA 12
pip install 'libucx-cu12>=1.19.0,<1.20'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since we're not planning to release ucx-py-cu12==0.46, anyone running these instructions will get ucx-py-cu12==0.45.

ucx-py-cu12==0.45 packages are pinned to not allow UCX 1.19:

- libucx-cu12>=1.15.0,<1.19

So I think something needs to be done here.

If the plan is to merge this into branch-0.46 and then branch-0.46 into main and then archive the repo, and for these docs to be the ones users find at https://ucx-py.readthedocs.io/en/latest/, then I think we need to also revert any docs changes about UCX 1.19, back to the range support by 0.45.

I think you may just want to do this on your PR branch:

git checkout branch-0.45 -- docs/

And then just manually re-add the warning added in #1167

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now I understand your point, previously I thought about this but thought it wasn't necessary because we can support 1.19.0, but I didn't think about pins in the 0.45 packages.

README.md Outdated
> [!WARNING]
> UCX-Py is deprecated and will be phased out soon, version 0.45 (RAPIDS 25.08) is expected to be the last release. Projects that rely on UCX-Py are advised to migrate to [UCXX](https://github.com/rapidsai/ucxx) immediately.
> [!CAUTION]
> UCX-Py has been discontinued, version 0.45 (RAPIDS 25.08) was its last release and it will receive no further updates. Projects depending on UCX-Py are advised to migrate to [UCXX](https://github.com/rapidsai/ucxx) immediately. [UCXX documentation](https://docs.rapids.ai/api/ucxx/nightly/).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> UCX-Py has been discontinued, version 0.45 (RAPIDS 25.08) was its last release and it will receive no further updates. Projects depending on UCX-Py are advised to migrate to [UCXX](https://github.com/rapidsai/ucxx) immediately. [UCXX documentation](https://docs.rapids.ai/api/ucxx/nightly/).
> UCX-Py has been discontinued, version 0.45 (RAPIDS 25.08) was its last release and it will receive no further updates. Projects depending on UCX-Py are advised to migrate to [UCXX](https://github.com/rapidsai/ucxx) immediately. [UCXX documentation](https://docs.rapids.ai/api/ucxx/nightly/). For more details, see https://docs.rapids.ai/notices/rsn0050/.

I think we should add a link to the RSN. That's helpful in teaching RAPIDS users that that's a section of the docs they should watch for breaking changes like this.

I've been doing that elsewhere, for that reason:

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done with a slightly reorder in phrasing, see 64f73f8, let me know if you prefer your phrasing/ordering instead.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks totally fine to me, all I cared about is getting the RSN link in there somewhere. Thanks!

@pentschev
Copy link
Member Author

If I've understood the plan correctly, I think we also need to update the version here:

# The full version, including alpha/beta/rc tags.
from ucp import __version__ as release
# The short X.Y version.
version = ".".join(release.split(".")[:2])

To a hard-coded:

version = "0.45.0"

You're right, sorry I forgot about this!

@pentschev
Copy link
Member Author

Thanks @jameslamb , I think I've addressed everything now, please have another look when you have a chance.

Copy link
Member

@jameslamb jameslamb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes are looking good to me, thank you!

@pentschev
Copy link
Member Author

Just realized one more thing that we want to change, which is the minimum UCX version, which is 1.15.0 in 0.45. Applied that change now in 4e88e63 .

@jameslamb
Copy link
Member

/merge

@rapids-bot rapids-bot bot merged commit 93b2e9d into rapidsai:branch-0.46 Sep 18, 2025
53 checks passed
@pentschev pentschev deleted the final-deprecation-changes branch September 18, 2025 20:43
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants