Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/reference/policies/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,6 @@

- [Versioning](./versioning.md)
- [Platform support](./platforms.md)
- [Python support](./python.md)
- [Rust support](./rust.md)
- [License](./license.md)
44 changes: 0 additions & 44 deletions docs/reference/policies/platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,47 +48,3 @@ The minimum supported Windows versions are Windows 10 and Windows Server 2016, f
uv supports macOS 13+ (Ventura).

uv is known to work on macOS 12, but requires installation of a `realpath` executable.

## Python support

uv supports and is tested against the following Python versions:

- 3.8
- 3.9
- 3.10
- 3.11
- 3.12
- 3.13
- 3.14

uv has Tier 1 support for the following Python implementations:

- CPython

As with platforms, Tier 1 support can be thought of "guaranteed to work". uv supports managed
installations of these implementations, and the builds are maintained by Astral.

uv has Tier 2 support for:

- PyPy
- GraalPy

uv is "expected to work" with these implementations. uv also supports managed installations of these
Python implementations, but the builds are not maintained by Astral.

uv has Tier 3 support for:

- Pyston
- Pyodide

uv "should work" with these implementations, but stability may vary.

## Minimum supported Rust version

The minimum supported Rust version required to compile uv is listed in the `rust-version` key of the
`[workspace.package]` section in `Cargo.toml`. It may change in any release (minor or patch). It
will never be newer than N-2 Rust versions, where N is the latest stable version. For example, if
the latest stable Rust version is 1.85, uv's minimum supported Rust version will be at most 1.83.

This is only relevant to users who build uv from source. Installing uv from the Python package index
usually installs a pre-built binary and does not require Rust compilation.
37 changes: 37 additions & 0 deletions docs/reference/policies/python.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Python support

## Python versions

uv supports and is tested against the following Python versions:

- 3.8
- 3.9
- 3.10
- 3.11
- 3.12
- 3.13
- 3.14

## Python implementations

uv has Tier 1 support for the following Python implementations:

- CPython

As with [platforms](./platforms.md), Tier 1 support can be thought of "guaranteed to work". uv
supports managed installations of these implementations, and the builds are maintained by Astral.

uv has Tier 2 support for:

- PyPy
- GraalPy

uv is "expected to work" with these implementations. uv also supports managed installations of these
Python implementations, but the builds are not maintained by Astral.

uv has Tier 3 support for:

- Pyston
- Pyodide

uv "should work" with these implementations, but stability may vary.
9 changes: 9 additions & 0 deletions docs/reference/policies/rust.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Rust support

The minimum supported Rust version required to compile uv is listed in the `rust-version` key of the
`[workspace.package]` section in `Cargo.toml`. It may change in any release (minor or patch). It
will never be newer than N-2 Rust versions, where N is the latest stable version. For example, if
the latest stable Rust version is 1.85, uv's minimum supported Rust version will be at most 1.83.

This is only relevant to users who build uv from source. Installing uv from the Python package index
usually installs a pre-built binary and does not require Rust compilation.
2 changes: 2 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -258,6 +258,8 @@ nav:
- reference/policies/index.md
- Versioning: reference/policies/versioning.md
- Platform support: reference/policies/platforms.md
- Python support: reference/policies/python.md
- Rust support: reference/policies/rust.md
- License: reference/policies/license.md
validation:
omitted_files: warn
Expand Down
Loading