DOC: Add install instructions for pixi and uv

timhoffm · timhoffm · commit 00148a8f3f61 · 2025-03-13T23:51:11.000+01:00
Closes #29746. Notes on issues with uv an tk taken from astral-sh/uv#6893 (comment)
diff --git a/doc/index.rst b/doc/index.rst
@@ -29,6 +29,32 @@ 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::
+
+           Python versions distributed by uv do not contain tk bindings that are
+           usable by Matplotlib (see `this issue`_ for details). Therefore, the
+           ``tkagg`` backend is not available. If you want matplotlib to be able
+           to display plots in a window, you should install one of the other
+           :ref:`supported GUI frameworks <optional_dependencies>`, 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
@@ -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
