This manual provides a step-by-step guide to set up a working environment on Windows for running the BlueMath notebooks.

1. Install Git on Windows

Git is required to clone the BlueMath repository from GitHub.

1. Go to: https://git-scm.com/download/win

2. Download the installer for your system (64-bit is recommended): https://github.com/git-for-windows/git/releases/download/v2.50.0.windows.1/Git-2.50.0-64-bit.exe

3. Run the installer and accept the default recommended options.

4. After installation, open Git Bash from the Start Menu and check the installation:

   git --version
   

2. Install Miniconda

Miniconda allows you to create isolated Python environments to manage dependencies.

1. Download Miniconda from: https://docs.conda.io/en/latest/miniconda.html

2. Choose the Windows installer (Python 3.x, 64-bit) and run it.

3. During installation, check the box that says “Add Miniconda to my PATH environment variable”

4. Open the Anaconda Prompt or Command Prompt and verify the installation:

   conda --version
   

3. Create the bluemathEnvironment

1. Open the Anaconda Prompt from the Start Menu.

2. Create a new environment named bluemath with the required packages:

   conda create -n bluemath python ipykernel 
   

3. Activate bluemath environment and install bluemath_tk pip package:

conda activate bluemath
pip install bluemath_tk

4. Install Visual Studio Code (VSCode)

1. Go to: https://code.visualstudio.com/