uv is now supported natively

2026-04-21T00:00:00-07:00

We are excited to announce that Read the Docs now supports uv natively in .readthedocs.yaml configuration file. This gives you a first-class way to install Python dependencies with uv during builds, without having to override install steps manually.

uv is generally faster than pip for most operations, and many users will see real speedups in doc building by migrating to the toolchain.

How to use it

Native uv support lives under python.install. Set method: uv and choose a command:

sync runs uv sync from your pyproject.toml or uv.lock file
pip runs uv pip install from a requirements file or path

Here is a small .readthedocs.yaml example using uv sync:

version: 2

build:
  os: ubuntu-24.04
  tools:
    python: "3.14"

python:
  install:
    - method: uv
      command: sync
      groups:
        - docs

If you prefer requirements-based workflows, you can use command: pip with either requirements or path.

python:
  install:
    - method: uv
      command: pip
      requirements: docs/requirements.txt

For full reference and more examples, see the documentation for uv in the config file reference.

Feedback welcome

If you are already building your docs with uv, we would love to hear how this works for your project. Please contact support and share your experience.

Read the Docs - Feature announcement

uv is now supported natively

How to use it

Feedback welcome