rye README

The project's README from github.com/astral-sh/rye. As one markdown file: README.md.

Rye: a Hassle-Free Python Experience


Rye

[!NOTE]

Rye is no longer developed. We encourage all users to use uv, the successor project from the same maintainers, which is actively maintained and much more widely used.

For current Rye users, please see the uv migration guide. While Rye will continue to be available, no further updates are planned, including security updates.

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

Watch the instruction

Click on the thumbnail to watch a 16 minute introduction video

In The Box

Rye picks and ships the right tools so you can get started in minutes:

Installation

The installation takes just a minute:

For more details and other options, refer to the installation instructions.

Learn More

Did I spark your interest?

More

rye (astral-sh/rye)

Searching Database…

14.1K ·GitHub
archived
What is this?Rye is an all-in-one project and package management tool for Python that handles installing Python versions, managing pyproject.toml-based projects, dependencies, and virtualenvs in one place.
Is this a CLI tool or a library I import into my code?It's a standalone command-line tool you install on your machine, not something you import into a Python project.
Do I need Python already installed to use it?No, Rye bootstraps its own Python using Indygreg Python Builds and PyPy binary distributions, so you don't need a pre-existing Python install.
Is Rye still being developed?No, Rye is archived and no longer developed, including no further security updates; the maintainers now point everyone to uv, their successor project.
What tools does Rye bundle under the hood?It bundles ruff for linting/formatting, virtualenv for environments, build for creating wheels, twine for publishing, and uv (falling back to unearth/pip-tools) for locking and installing dependencies.
Should I use Rye or uv for a new project?Use uv instead — it's the actively maintained successor built by the same team, and Rye itself is no longer updated.
Can Rye manage multi-package projects?Yes, Rye has built-in workspace support for working with complex projects made up of multiple libraries.
How do I migrate an existing Rye project away from it?The project points existing users to the official uv migration guide for moving off Rye.
What are similar projects?poetry, pip, composer, uv, pyinstaller, gvm, dep, pipx
Creator
astral-sh
Size
3.5 MB
Stars
14.1K
Age
3y
Commits · 90 Days