Files
uv/docs/reference/policies/platforms.md
T
2026-03-07 09:12:36 -06:00

2.8 KiB

Platform support

uv has Tier 1 support for the following platforms:

  • macOS (Apple Silicon)
  • macOS (x86_64)
  • Linux (x86_64)
  • Windows (x86_64)

uv is continuously built, tested, and developed against its Tier 1 platforms. Inspired by the Rust project, Tier 1 can be thought of as "guaranteed to work".

uv has Tier 2 support ("guaranteed to build") for the following platforms:

  • Linux (PPC64LE)
  • Linux (RISC-V64)
  • Linux (aarch64)
  • Linux (armv7)
  • Linux (i686)
  • Linux (s390x)
  • Windows (arm64)

uv has Tier 3 support ("best effort") for the following platforms:

  • FreeBSD (x86_64)
  • Windows (i686)

uv provides official binaries on GitHub and pre-built wheels on PyPI for its Tier 1 and Tier 2 platforms.

Tier 2 platforms are continuously built, but the uv test suite is not run on them and stability may vary in practice.

Tier 3 platforms may not be built or tested, but uv will accept patches to fix bugs.

Windows versions

The minimum supported Windows versions are Windows 10 and Windows Server 2016, following Rust's own Tier 1 support.

macOS versions

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.