8 views
# Carpentry installation instructions ##### Bash shell - All operating systems Refer to [The Bash Shell](https://carpentries.github.io/workshop-template/install_instructions/#the-bash-shell) installation instructions which will install `bash` if necessary. ##### Git - All operating systems Refer to [Git](https://carpentries.github.io/workshop-template/install_instructions/#git-1) installation instructions which will install `git` if necessary. ##### Python - Windows ###### Install conda-forge / miniforge3 1. Download [conda-forge](https://conda-forge.org/download/) for Windows 2. Allow download and execute the file despite security warnings (Windows / Google Chrome) 3. Install miniforge3/conda-forge with default/recommended settings. - "Register Miniforge3 as my default Python 3.12" - "Clear the package cache upon completion" 4. The installation is now complete. ###### Install dependencies needed for the course 1. After installation find "Miniforge Prompt" in the menu and launch it. 2. In the Miniforge Prompt type `conda create --name swc2025 python=3.12 jupyterlab numpy matplotlib` and press Enter/Return 3. When asked to `Proceed` press Enter/Return 4. Type `conda activate swc2025` and press Enter/Return 5. To test if Jupyter Lab was correctly installed type `jupyter-lab` and press Enter/Return. A browser window should open automatically. If not, follow the instructions on screen and copy the provided URL and token. 6. To stop Jupyter Lab simply close the "Miniforge Prompt" window. 7. The installation is now complete. ###### During the course 1. To launch **Jupyter Lab** during the course, open the "Miniforge Prompt" 2. Type `conda activate swc2025` and press Enter/Return 3. Type `jupyter-lab` and press Enter/Return to re-launch "Jupyter Lab" or follow the instructions on the "Miniforge Prompt" window. 4. To stop Jupyter Lab close the "Miniforge Prompt" window. ##### Python - MacOS ###### Install conda-forge / miniforge3 1. Access ["About This Mac" in the MacOS Menu](https://support.apple.com/guide/mac-help/get-system-information-about-your-mac-syspr35536/mac) and identify if your computer has an **Intel processor** (x86_64) or an M1/M2/M3 processor (arm64 - Apple Silicon). 2. Download [conda-forge](https://conda-forge.org/download/) matching your processor. The file will be named `Miniforge3-MacOSX-x86_64.sh` or `Miniforge3-MacOSX-arm64.sh` depending on if you downloaded the Intel or Apple Silicon file. 3. Launch the "Terminal" application 4. Type `cd Downloads` and press Enter/Return. If asked, allow "Terminal" to access this folder. 5. Type `bash Miniforge3-MacOSX-x86_64.sh` or `bash Miniforge3-MacOSX-arm64.sh`, depending on which you downloaded, and press Enter/Return. 6. Press Enter/Return to accept the license agreement. 7. A `:` should appear at the start of the last line. Type `q` then `yes` followed by Enter/Return to accept the license terms. 8. Press Enter/Return again to confirm the installation location. Typically `/Users/yourusername/miniforge3`. 9. After some processing time, you will be asked if you want to auto-initialize conda. Answer `yes` and press Enter/Return to confirm. The installation process should now be complete. 10. Open a new "Terminal" or a new Terminal tab. 11. Type `conda config --set auto_activate_base false` and press Enter/Return to prevent automatic activation of the `base` conda environment. 12. You can now close all "Terminal" tabs and the installation is complete. ###### Install dependencies needed for the course 1. Open a new "Terminal" or tab 2. Type `conda create --name swc2025 python=3.12 jupyterlab numpy matplotlib` and press Enter/Return 3. When asked to `Proceed` press Enter/Return 4. Type `conda activate swc2025` and press Enter/Return 5. To test if Jupyter Lab was correctly installed type `jupyter-lab` and press Enter/Return. A browser window should open automatically. If not, follow the instructions on screen and copy the provided URL and token. 6. To stop Jupyter Lab simply close the "Terminal" tab. 7. The installation is now complete. ###### During the course 1. To launch **Jupyter Lab** during the course, open the "Terminal" 2. Type `conda activate swc2025` and press Enter/Return 3. Type `jupyter-lab` and press Enter/Return to re-launch "Jupyter Lab" or follow the instructions on the "Miniforge Prompt" window. 4. To stop Jupyter Lab close the "Terminal" tab. ##### Python - Linux ###### Install conda-forge / miniforge3 1. Download [conda-forge](https://conda-forge.org/download/) matching your CPU architecture. The file will be named `Miniforge3-Linux-CPU.sh` where CPU is the architecture chosen. Make note if the file was saved to your `Downloads` directory or a different location. 1. Launch a "Terminal" application 3. Type `cd Downloads` and press Enter/Return. If you saved the file in a different location use `cd Location/Sublocation`. 4. Type `bash Miniforge3-Linux-x86_64.sh` or whichever file you downloaded and press Enter/Return. 6. Press Enter/Return to accept the license agreement. 7. If a `:` appears at the start of the last line. Type `q` then `yes` followed by Enter/Return to accept the license terms. 8. Press Enter/Return again to confirm the installation location. Typically `/home/yourusername/miniforge3`. 9. After some processing time, you will be asked if you want to auto-initialize conda. Answer `yes` and press Enter/Return to confirm. The installation process should now be complete. 10. Open a new "Terminal" or a new Terminal tab. 11. Type `conda config --set auto_activate_base false` and press Enter/Return to prevent automatic activation of the `base` conda environment. 12. You can now close all "Terminal" tabs and the installation is complete. ###### Install dependencies needed for the course 1. Open a new "Terminal" or tab 2. Type `conda create --name swc2025 python=3.12 jupyterlab numpy matplotlib` and press Enter/Return 3. When asked to `Proceed` press Enter/Return 4. Type `conda activate swc2025` and press Enter/Return 5. To test if Jupyter Lab was correctly installed type `jupyter-lab` and press Enter/Return. A browser window should open automatically. If not, follow the instructions on screen and copy the provided URL and token. 6. To stop Jupyter Lab simply close the "Terminal". 7. The installation of dependencies is now complete. ###### During the course 1. To launch **Jupyter Lab** during the course, open the "Terminal" 2. Type `conda activate swc2025` and press Enter/Return 3. Type `jupyter-lab` and press Enter/Return to re-launch "Jupyter Lab" or follow the instructions on the "Miniforge Prompt" window. 4. To stop Jupyter Lab close the "Terminal" tab.