From 173510e0107f001dfe78649f4f89712048b58d2d Mon Sep 17 00:00:00 2001 From: Kevin Tyle Date: Mon, 30 Sep 2024 16:41:41 -0400 Subject: [PATCH] Update installation instructions to use miniforge/mamba (#491) * Miniforge edits part 1 * Eliminate Anaconda distribution references * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> --- foundations/conda.md | 7 ++++--- foundations/jupyter.md | 11 ++++------- foundations/terminal.md | 2 +- 3 files changed, 9 insertions(+), 11 deletions(-) diff --git a/foundations/conda.md b/foundations/conda.md index 5d4174f68..a936bf579 100644 --- a/foundations/conda.md +++ b/foundations/conda.md @@ -31,16 +31,17 @@ Package management is useful because you may want to update a package for one of ## Installing Conda -We recommend you install Miniconda. You can do that by following the [instructions for your machine](https://docs.conda.io/en/latest/miniconda.html). +We recommend you install Miniforge. You can do that by following the [instructions for your machine](https://github.com/conda-forge/miniforge). -Miniconda only comes with the `conda` package management system; it is a pared-down version of the full Anaconda Python distribution. +Miniforge uses the `conda` package management system and is based on Miniconda, which is a pared-down version of the full Anaconda Python distribution. [Installing Anaconda](https://docs.anaconda.com/anaconda/install/) takes longer and uses up more disk space, but provides you with more functionality, including Spyder (a Python-specific integrated development environment or IDE) and Jupyter, in addition to other immediately installed packages. Also, the interface of Anaconda is great if you are uncomfortable with the terminal. -We recommend Miniconda for two reasons: +We recommend Miniforge for these reasons: 1. It's quicker and takes up less disk space. 2. It encourages you to install only the packages you need in reproducible isolated environments for specific projects. This is generally a more robust way to work with open source tools. +3. It uses `conda-forge` as the default channel for packages. Once you have `conda` via the Miniconda installer, the next step is to create an environment and install packages. diff --git a/foundations/jupyter.md b/foundations/jupyter.md index 763072c7f..8211d6e62 100644 --- a/foundations/jupyter.md +++ b/foundations/jupyter.md @@ -24,7 +24,7 @@ You'd like to learn to run Python in a Jupyter session. Here we will cover: To run a Jupyter session, you will need to install some necessary packages into your Conda environment. -Install `miniconda` by following the [instructions for your machine](https://docs.conda.io/en/latest/miniconda.html). +Install `miniforge` by following the [instructions for your machine](https://github.com/conda-forge/miniforge). [Learn more about Conda here](conda.md) @@ -41,11 +41,7 @@ $ conda activate pythia_foundations_env $ jupyter lab ``` -Or you can install the full [Anaconda](https://www.anaconda.com/products/distribution), and select **LAUNCH** under the Jupyter panel in the GUI. - -![Anaconda Navigator](../images/Anaconda.png) - -In both methods, a new window should open automatically in your default browser. You can change the browser when launching from the terminal with (for example): +A new window should open automatically in your default browser. You can change the browser when launching from the terminal with (for example): ``` jupyter lab —browser=chrome @@ -121,4 +117,5 @@ Jupyter notebooks are a free, open-source, interactive tool running inside a web ## Resources and References -- [Anaconda](https://www.anaconda.com/products/distribution) +- [conda-forge](https://conda-forge.org) +- [Miniforge Releases](https://conda-forge.org/miniforge/) diff --git a/foundations/terminal.md b/foundations/terminal.md index 49568964d..866186ebd 100644 --- a/foundations/terminal.md +++ b/foundations/terminal.md @@ -21,7 +21,7 @@ You'd like to learn to run Python in the terminal. Here we will cover: ## Installing Python in the Terminal -If you are running Python in the terminal, it is best to install Miniconda. You can do that by following the [instructions for your machine](https://docs.conda.io/en/latest/miniconda.html). +If you are running Python in the terminal, it is best to install Miniforge. You can do that by following the [instructions for your machine](https://github.com/conda-forge/miniforge). [Learn more about Conda here](conda.md)