From 92afbe7932d00ef9b17842096a8fa89cfe53b658 Mon Sep 17 00:00:00 2001 From: Pavel Zwerschke Date: Mon, 24 Feb 2025 09:59:15 +0100 Subject: [PATCH] docs: Mention add_pip_as_python_dependency in compatibility mode (#103) --- .github/PULL_REQUEST_TEMPLATE.md | 6 ++++++ README.md | 8 ++++++++ 2 files changed, 14 insertions(+) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 3fa37b7..1a882bd 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -5,3 +5,9 @@ # Changes + +--- + +If updating documentation: + +- [ ] Updated documentation in https://github.com/prefix-dev/pixi/blob/main/docs/advanced/production_deployment.md as well diff --git a/README.md b/README.md index aa0d567..4ba0810 100644 --- a/README.md +++ b/README.md @@ -198,3 +198,11 @@ conda env create -p ./env --file environment.yml > [!NOTE] > The `environment.yml` and `repodata.json` files are only for this use case, `pixi-pack unpack` does not use them. + +> [!NOTE] +> Both `conda` and `mamba` are always installing pip as a side effect when they install python, see [`conda`'s documentation](https://docs.conda.io/projects/conda/en/25.1.x/user-guide/configuration/settings.html#add-pip-as-python-dependency-add-pip-as-python-dependency). +> This is not different from how `pixi` works and can lead to solver errors when using `pixi-pack`'s compatibility mode since `pixi-pack` doesn't include `pip` by default. +> You can fix this issue in two ways: +> +> - Add `pip` to your `pixi.lock` file using `pixi add pip`. +> - Configuring `conda` (or `mamba`) to not install `pip` by default by running `conda config --set add_pip_as_python_dependency false` (or by adding `add_pip_as_python_dependency: False` to your `~/.condarc`)