LLMs-from-scratch/appendix-A/01_optional-python-setup-preferences/README.md

# Python Setup Tips



There are several different ways you can install Python and set up your computing environment. Here, I am illustrating my personal preference. 

(I am using computers running macOS, but this workflow is similar for Linux machines and may work for other operating systems as well.)



## 1. Download and install Miniforge

Download miniforge from the GitHub repository [here](https://github.com/conda-forge/miniforge).

<img src="figures/download.png" alt="download" style="zoom:33%;" />

Depending on your operating system, this should download either an `.sh` (macOS, Linux) or `.exe` file (Windows). 

For the `.sh` file, open your command line terminal and execute the following command

```bash
sh ~/Desktop/Miniforge3-MacOSX-arm64.sh
```

where `Desktop/` is the folder where the Miniforge installer was downloaded to. On your computer, you may have to replace it with `Downloads/`.

<img src="figures/miniforge-install.png" alt="miniforge-install" style="zoom:33%;" />

Next, step through the download instructions, confirming with "Enter".



## 2. Create a new virtual environment

After the installation was successfully completed, I recommend creating a new virtual environment called `dl-fundamentals`, which you can do by executing

```bash
conda create -n LLMs python=3.10
```

<img src="figures/new-env.png" alt="new-env" style="zoom:33%;" />

> Many scientific computing libraries do not immediately support the newest version of Python. Therefore, when installing PyTorch, it's advisable to use a version of Python that is one or two releases older. For instance, if the latest version of Python is 3.13, using Python 3.10 or 3.11 is recommended.

Next, activate your new virtual environment (you have to do it every time you open a new terminal window or tab):

```bash
conda activate dl-workshop
```

<img src="figures/activate-env.png" alt="activate-env" style="zoom:33%;" />

## Optional: styling your terminal

If you want to style your terminal similar to mine so that you can see which virtual environment is active,  check out the [Oh My Zsh](https://github.com/ohmyzsh/ohmyzsh) project.



## 3. Install new Python libraries



To install new Python libraries, you can now use the `conda` package installer. For example, you can install [JupyterLab](https://jupyter.org/install) and [watermark](https://github.com/rasbt/watermark) as follows:

```bash
conda install jupyterlab watermark
```

<img src="figures/conda-install.png" alt="conda-install" style="zoom:33%;" />



You can also still use `pip` to install libraries. By default, `pip` should be linked to your new `LLms` conda environment:

<img src="figures/check-pip.png" alt="check-pip" style="zoom:33%;" />



## 4. Install PyTorch

PyTorch can be installed just like any other Python library or package using pip. For example:

```bash
pip install torch==2.0.1
```

However, since PyTorch is a comprehensive library featuring CPU- and GPU-compatible codes, the installation may require additional settings and explanation (see the *A.1.3 Installing PyTorch in the book for more information*).

It's also highly recommended to consult the installation guide menu on the official PyTorch website at [https://pytorch.org](https://pytorch.org).

<img src="figures/pytorch-installer.jpg" width="600px">



---




Any questions? Please feel free to reach out in the [Discussion Forum](https://github.com/rasbt/LLMs-from-scratch/discussions).