diff --git a/doc/index.rst b/doc/index.rst index dedd614985df..74a183d6cd7b 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -29,6 +29,34 @@ Install conda install -c conda-forge matplotlib + .. tab-item:: pixi + + .. code-block:: bash + + pixi add matplotlib + + .. tab-item:: uv + + .. code-block:: bash + + uv add matplotlib + + .. warning:: + + If you install Python with ``uv`` then the ``tkagg`` backend + will not be available because python-build-standalone (used by uv + to distribute Python) does not contain tk bindings that are usable by + Matplotlib (see `this issue`_ for details). If you want Matplotlib + to be able to display plots in a window, you should install one of + the other :ref:`supported GUI frameworks `, + e.g. + + .. code-block:: bash + + uv add matplotlib pyside6 + + .. _this issue: https://github.com/astral-sh/uv/issues/6893#issuecomment-2565965851 + .. tab-item:: other .. rst-class:: section-toc diff --git a/doc/install/index.rst b/doc/install/index.rst index 8f9c91427f70..3e6452eb2f41 100644 --- a/doc/install/index.rst +++ b/doc/install/index.rst @@ -28,7 +28,8 @@ precompiled wheel for your OS and Python. The following backends work out of the box: Agg, ps, pdf, svg Python is typically shipped with tk bindings which are used by - TkAgg. + TkAgg. Notably, python-build-standalone – used by ``uv`` – does + not include tk bindings that are usable by Matplotlib. For support of other GUI frameworks, LaTeX rendering, saving animations and a larger selection of file formats, you can