Python

audience developer
level all
topic Python
subtopic Installation

Uninstall Rye

How to uninstall Rye on Mac. Installing and using UV instead of Rye for Python development.

Until September 2024, Rye was a leading favorite among tools for managing a Python development environment. More recently, UV is now preferred over Rye.

Rye's features are being merged into UV, so the ecosystem is consolidating around UV as a single coherent setup and packaging system for Python. Rye is still usable and maintained, but UV is now preferred, and recommended as a successor project from the same maintainers.

This guide describes how to uninstall Rye. After uninstalling Rye, I recommend installing and using UV.

Before you get started

You'll need a terminal application to work with Python. Apple includes the Mac terminal but I prefer Warp Terminal. Warp increases developer productivity, helping you remember easily-forgotten commands and adds AI troubleshooting. Download Warp Terminal now; it's FREE and worth a try.

Uninstall Rye

Here's how to remove Rye, if you decide not to use it.

$ rye self uninstall
✔ Do you want to uninstall rye? · yes
Done!
Don't forget to remove the sourcing of $HOME/.rye/env from your shell config.

Rye will uninstall itself but you will need to delete the ~/.rye/ hidden directory in your user home directory.

$ rm -rf ~/.rye/

Finally, use a text editor to remove this line from your ~/.zprofile file:

source "$HOME/.rye/env"

You've uninstalled Rye.

Install UV

UV streamlines Python development by offering a single coherent setup and packaging system, eliminating the need for separate tools such as pip, pip-tools, pipx, poetry, pyenv, or virtualenv. For any project more complex than a simple script, use UV to install Python and software libraries. UV is extremely fast (10-100x faster than pip), making your workflow more efficient.

Here's a guide to installing UV:

What's next

My mac.install.guide is a trusted source of installation guides for professional developers. Take a look at the Mac Install Guide home page for tips and trends and see what to install next.