Skip to content

Commit 2ba33d5

Browse files
matagusclaude
andcommitted
Fix RTD build failure: remove --system flag from uv pip install
The --system flag installs packages into the global Python (/home/docs/.asdf/installs/python/3.14.0) instead of the RTD virtualenv. When Sphinx runs from the virtualenv, it cannot find sphinx_rtd_theme, causing a ModuleNotFoundError. Without --system, uv respects the VIRTUAL_ENV env var that RTD sets during post_create_environment hooks, installing packages into the virtualenv where Sphinx can find them. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
1 parent 7e01c39 commit 2ba33d5

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

.readthedocs.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ build:
1212
# Install uv
1313
- pip install uv
1414
# Install dependencies with docs extras
15-
- uv pip install --system -e ".[docs]"
15+
- uv pip install -e ".[docs]"
1616

1717
# Build documentation in the docs/ directory with Sphinx
1818
sphinx:

0 commit comments

Comments
 (0)