diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 7213a7b8c..ca3c427f5 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -19,7 +19,7 @@ jobs:
       - uses: conda-incubator/setup-miniconda@v2
         with:
           activate-environment: gt4sd
-          environment-file: conda.yml
+          environment-file: conda_cpu_linux.yml
           auto-activate-base: false
           use-only-tar-bz2: true
       - name: Build docs
diff --git a/.github/workflows/tests.yaml b/.github/workflows/tests.yaml
index 02c0f580a..35a7dd7e7 100644
--- a/.github/workflows/tests.yaml
+++ b/.github/workflows/tests.yaml
@@ -24,7 +24,7 @@ jobs:
       - uses: conda-incubator/setup-miniconda@v2
         with:
           activate-environment: gt4sd
-          environment-file: conda.yml
+          environment-file: conda_cpu_linux.yml
           auto-activate-base: false
           use-only-tar-bz2: true
       - name: Install gt4sd from source
@@ -37,10 +37,10 @@ jobs:
           python -m black src/gt4sd --check --diff --color
       - name: Remove unnecessary files (see https://stackoverflow.com/questions/75536771/github-runner-out-of-disk-space-after-building-docker-image)
         run: |
-          sudo rm -rf /usr/share/dotnet
-          sudo rm -rf /opt/ghc
-          sudo rm -rf "/usr/local/share/boost"
-          sudo rm -rf "$AGENT_TOOLSDIRECTORY"
+        sudo rm -rf /usr/share/dotnet
+        sudo rm -rf /opt/ghc
+        sudo rm -rf "/usr/local/share/boost"
+        sudo rm -rf "$AGENT_TOOLSDIRECTORY"
       - name: Check flake8
         run: |
           conda activate gt4sd
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a4610c9af..512eebe15 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -48,7 +48,7 @@ If you would like to contribute to the package, we recommend the following devel
 5. Create and activate a dedicated conda environment:
 
     ```sh
-    conda env create -f conda.yml
+    conda env create -f conda_cpu_mac.yml
     conda activate gt4sd
     ```
 
diff --git a/README.md b/README.md
index 6cc548715..7be613f0e 100644
--- a/README.md
+++ b/README.md
@@ -39,12 +39,12 @@ The recommended way to install the `gt4sd` is to create a dedicated conda enviro
 ```sh
 git clone https://github.com/GT4SD/gt4sd-core.git
 cd gt4sd-core/
-conda env create -f conda.yml 
+conda env create -f conda_cpu_mac.yml # for linux use conda_cpu_linux.yml
 conda activate gt4sd
 pip install gt4sd
 ```
 
-**NOTE 1:** By default `gt4sd` is installed with CPU requirements. For GPU usage replace `conda env create -f conda.yml` with:
+**NOTE 1:** By default `gt4sd` is installed with CPU requirements. For GPU usage replace with:
 ```sh
 conda env create -f conda_gpu.yml
 ```
@@ -59,12 +59,10 @@ A few VCS dependencies require Git LFS (make sure it's available on your system)
 
 ### Development setup & installation
 
-If you would like to contribute to the package, we recommend the following development setup:
+If you would like to contribute to the package, we recommend to install gt4sd in
+editable mode inside your `conda` environment:
 
 ```sh
-conda env create -f conda.yml
-conda activate gt4sd
-# install gt4sd in editable mode
 pip install --no-deps -e .
 ```
 
diff --git a/docs/source/gt4sd_inference_usage_md.md b/docs/source/gt4sd_inference_usage_md.md
index c0f6651f3..a50a31ca8 100644
--- a/docs/source/gt4sd_inference_usage_md.md
+++ b/docs/source/gt4sd_inference_usage_md.md
@@ -17,11 +17,11 @@ This notebook show the basic usage of the GT4SD algorithms.
 
 ### A note on the setup
 
-In the following we assume that the toolkit has been setup using the provided `conda.yml` as follows:
+In the following we assume that the toolkit has been setup using your preferred `conda` `yml` file as follows:
 
 ```{code-block} sh
 # create and activate environment
-conda env create -f conda.yml
+conda env create -f conda_cpu_mac.yml # or conda_cpu_linux.yml or conda_gpu.yml
 conda activate gt4sd
 # install the toolkit
 pip install .