Rye: a Hassle-Free Python Experience

Note

If you're getting started with Rye, consider uv, the successor project from the same maintainers.

While Rye is actively maintained, uv offers a more stable and feature-complete experience, and is the recommended choice for new projects.

Having trouble migrating? Let us know what's missing.

Rye is a comprehensive project and package management solution for Python. Born from its creator's desire to establish a one-stop-shop for all Python users, Rye provides a unified experience to install and manages Python installations, pyproject.toml based projects, dependencies and virtualenvs seamlessly. It's designed to accommodate complex projects, monorepos and to facilitate global tool installations. Curious? Watch an introduction.

A hassle-free experience for Python developers at every level.

Star Discuss Sponsor

Installation Instructions

To install you can run a curl command which will install the right binary for your operating system and CPU architecture and install it:

curl -sSf https://rye.astral.sh/get | bash

Alternatively if you don't trust this approach, you can download the latest release binary. On first run it will install itself.

gunzip rye-x86_64-linux.gz
chmod +x ./rye-x86_64-linux
./rye-x86_64-linux

To install you can run a curl command which will install the right binary for your operating system and CPU architecture and install it:

curl -sSf https://rye.astral.sh/get | bash

Alternatively if you don't trust this approach, you can download the latest release binary. On first run it will install itself.

gunzip rye-aarch64-macos.gz
chmod +x ./rye-aarch64-macos
./rye-aarch64-macos

To install Rye on windows download the latest release and run the binary. Upon first run it will install itself. Please note that it's strongly recommended to have "Developer Mode" activated when using Rye and before starting the installation. Learn more.

Note

Rye does not yet use signed binaries which means that you will need to allow the execution of the downloaded executable. If there is no obvious way to do so, click on "More info" on the error message that shows up and then on "Run anyway".

Additionally sometimes a Trojan warning about "Bearfoos" is shown. This is a false positive. For more information see the discussion Windows Bearfoos virus associated with rye.

You need to have Rust and Cargo installed. If you don't have, you can use rustup to get them onto your machine.

Afterwards you can install Rye via cargo:

cargo install --git https://github.com/astral-sh/rye rye

For the next steps or ways to customize the installation, head over to the detailed installation guide.