Skip to content

Commit

Permalink
Update installation instructions to use miniforge/mamba (#491)
Browse files Browse the repository at this point in the history
* 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>
  • Loading branch information
ktyle and pre-commit-ci[bot] authored Sep 30, 2024
1 parent 80a71b8 commit 173510e
Show file tree
Hide file tree
Showing 3 changed files with 9 additions and 11 deletions.
7 changes: 4 additions & 3 deletions foundations/conda.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
11 changes: 4 additions & 7 deletions foundations/jupyter.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand All @@ -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
Expand Down Expand Up @@ -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/)
2 changes: 1 addition & 1 deletion foundations/terminal.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down

0 comments on commit 173510e

Please sign in to comment.