Python

Written & tested for accuracy by a developer (not AI)

Rye is Archived: Use uv Instead

Rye is no longer developed and its repository is archived. Use uv instead, the successor project from the same maintainers. How to migrate a Rye project to uv, and how to uninstall Rye on Mac.

Rye was an all-in-one Python project and package manager. It installed Python versions, created virtual environments, and managed a project's dependencies from a single command, much as uv does today.

Important: do not start a new Python project with Rye. Astral stopped developing Rye in February 2025, and the project's GitHub repository is now archived. The final release was version 0.44.0, in February 2025.

Astral's own guidance is unambiguous. Rye will remain available, but no further updates are planned, including security updates. That last part is the one that matters. A tool that manages your Python installation and your project dependencies but will never receive another security fix is not a safe foundation for new work.

The replacement is uv, from the same maintainers. Rye's features were folded into uv, which is actively developed and far more widely used. If you are starting fresh, skip Rye entirely.

Moving from Rye to uv is one step in setting up your Mac for development. See the roadmap for everything else.

Before you get started

You'll need a terminal application to install and use 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.

What to do instead

Install uv. It replaces pip, pip-tools, pipx, poetry, pyenv, and virtualenv with a single tool, and it is dramatically faster than the tools it replaces.

If you would rather not use uv at all, Homebrew is the simplest way to get a working Python on a Mac.

Migrating an existing Rye project

Astral publish a step-by-step migration guide covering the parts that do not translate automatically: [tool.rye.scripts], [[tool.rye.sources]], shims, lockfiles, and the rye lint, rye fmt, and rye test commands.

Because both tools read pyproject.toml, most projects need less work than you would expect. Start with the guide above rather than reconstructing the project by hand.

Uninstall Rye

Once you have migrated, remove Rye. Ask it to uninstall itself:

$ 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.

Then delete the ~/.rye/ hidden directory that remains in your home folder:

$ rm -rf ~/.rye/

Finally, use a text editor to remove this line from your ~/.zprofile file, which adds Rye's shims to your Mac PATH:

source "$HOME/.rye/env"

Rye stores nothing outside those locations. Important: virtual environments that Rye created will stop working once Rye is uninstalled, so migrate your projects to uv before you remove it, not after.

Continue setting up your Mac

Don't miss the full visual roadmap and checklist that shows how to set up a Mac for software development, with all the essential tools and settings you might not yet know about.