diff --git a/aider/website/_includes/conflicts.md b/aider/website/_includes/conflicts.md
new file mode 100644
index 000000000..51f2cc7ba
--- /dev/null
+++ b/aider/website/_includes/conflicts.md
@@ -0,0 +1,17 @@
+
+## Avoid package conflicts
+
+If you are using aider to work on a python project, sometimes your project will require
+specific versions of python packages which conflict with the versions that aider
+requires.
+If this happens, the `python -m pip install` command may return errors like these:
+
+```
+aider-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage U.W.V which is incompatible.
+```
+
+You can avoid this problem by installing aider using `pipx` or `uv`,
+which will install it globally on your system
+within its own python environment.
+This way you can use aider to work on any python project,
+even if that project has conflicting dependencies.
diff --git a/aider/website/docs/install/uv.md b/aider/website/docs/install/uv.md
new file mode 100644
index 000000000..096fd818a
--- /dev/null
+++ b/aider/website/docs/install/uv.md
@@ -0,0 +1,15 @@
+---
+parent: Installation
+nav_order: 100
+---
+
+# Install with uv
+
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/) then do:
+
+```
+uv install tool aider-chat
+```
+
+{% include conflicts.md %}