Installing Python

Install Miniforge¶

As of January 2025, we recommend installing Miniforge rather than Anaconda, for reasons of simplicity and licensing:

1. Miniforge installer, you may need to have a look at the Miniforge documentation for more information. Mamba is already included in Miniforge.

Environment setup¶

Create an environment with the following command:

1. Download the environment file positron_env.yaml and put it in the current folder.

2. Run the following command:

   mamba env create --file=positron_env.yaml

   If you don’t have mamba installed, you can use conda instead:

   conda env create --file=positron_env.yaml

   The install process will just be a bit slower.

3. Activate the environment:

   conda activate positron

Run all examples locally¶

At this point, you should have all the necessary packages installed. You can run Jupyter Lab with the following command:

jupyter lab

And Jupyter Notebook with:

jupyter notebook

Installing GIT¶

If you’re new to Python, learning Git is a game-changer! It helps you track changes, undo mistakes, and collaborate easily. With GitHub or GitLab, you can contribute to open-source projects and showcase your work. Start using Git early—it’ll make your coding journey way smoother!

Procedure¶

• For Windows users: GIT-SCM

• Linux: GIT is already instlalled

• MAC OS: for example, install it via Brew brew install git

Installing VSCode¶

Visual Studio Code (VSCode) is a lightweight but powerful source code editor that runs on your desktop.

Procedure¶

1. Download the installer from the VSCode website.

2. Run the installer and follow the instructions.

3. Open VSCode and install the Python extension by Microsoft.