diff --git a/README.md b/README.md index 6dd31be3e231..5241ddc96b2e 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ To get the library from the latest release, follow the instructions from To install `dpnp` from the Intel(R) conda channel, use the following command: ```bash -conda install dpnp -c https://software.repos.intel.com/python/conda/ -c conda-forge +conda install dpnp -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels ``` ## Pip @@ -60,7 +60,7 @@ To try out the latest features, install `dpnp` using our development channel on Anaconda cloud: ```bash -conda install dpnp -c dppy/label/dev -c https://software.repos.intel.com/python/conda/ -c conda-forge +conda install dpnp -c dppy/label/dev -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels ``` diff --git a/doc/quick_start_guide.rst b/doc/quick_start_guide.rst index b21cd06a4104..7467b3a1833f 100644 --- a/doc/quick_start_guide.rst +++ b/doc/quick_start_guide.rst @@ -42,7 +42,7 @@ Install Package from Intel(R) channel You will need one of the commands below: -* Conda: ``conda install dpnp -c https://software.repos.intel.com/python/conda/ -c conda-forge`` +* Conda: ``conda install dpnp -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels`` * Pip: ``python -m pip install --index-url https://software.repos.intel.com/python/pypi dpnp`` @@ -50,6 +50,12 @@ These commands install dpnp package along with its dependencies, including ``dpctl`` package with `Data Parallel Control Library`_ and all required compiler runtimes and OneMKL. +.. warning:: + Packages from the Intel channel are meant to be used together with dependencies from the **conda-forge** channel, and might not + work correctly when used in an environment where packages from the ``anaconda`` default channel have been installed. It is + advisable to use the `miniforge `__ installer for ``conda``/``mamba``, as it comes with + ``conda-forge`` as the only default channel. + .. note:: Before installing with conda or pip it is strongly advised to update ``conda`` and ``pip`` to latest versions @@ -68,7 +74,7 @@ And to build dpnp package from the sources: .. code-block:: bash - conda build conda-recipe -c https://software.repos.intel.com/python/conda/ -c conda-forge + conda build conda-recipe -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels Finally, to install the result package: @@ -90,7 +96,7 @@ On Linux: conda create -n build-env dpctl cython dpcpp_linux-64 mkl-devel-dpcpp tbb-devel \ onedpl-devel cmake scikit-build ninja pytest intel-gpu-ocl-icd-system \ - -c dppy/label/dev -c https://software.repos.intel.com/python/conda/ -c conda-forge + -c dppy/label/dev -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels conda activate build-env On Windows: @@ -99,7 +105,7 @@ On Windows: conda create -n build-env dpctl cython dpcpp_win-64 mkl-devel-dpcpp tbb-devel \ onedpl-devel cmake scikit-build ninja pytest intel-gpu-ocl-icd-system \ - -c dppy/label/dev -c https://software.repos.intel.com/python/conda/ -c conda-forge + -c dppy/label/dev -c https://software.repos.intel.com/python/conda/ -c conda-forge --override-channels conda activate build-env To build and install the package on Linux OS, run: