# Set up the environment

## In this learning path

- [Introduction](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/yolo-on-himax/)
- [Overview](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/yolo-on-himax/overview/)
- [Set up the environment](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/yolo-on-himax/dev-env/)
- [Build the firmware](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/yolo-on-himax/build-firmware/)
- [Flash firmware onto the microcontroller](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/yolo-on-himax/flash-and-run/)
- [Run additional models in the web toolkit](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/yolo-on-himax/web-toolkit/)
- [Next Steps](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/yolo-on-himax/_next-steps/)

This Learning Path has been validated on Ubuntu 22.04 LTS and macOS.

> **Tip**  
> If you are running Windows, you can use Ubuntu through Windows subsystem for Linux 2 (WSL2). Check out [Get started with Windows Subsystem for Linux (WSL) on Arm](https://learn.arm.com/learning-paths/laptops-and-desktops/wsl2/setup/) to learn more.

## Install software tools

Follow the instructions below to install the required development tools.

### Install Python and Pip

You will use Python to build the firmware image and pip to install additional dependencies.

Verify Python is installed by running:

```bash
python3 --version
```

You should see an output like the following:

```bash
__output__Python 3.12.7
```

On Ubuntu, you may need to install `pip` and `venv` with the following commands:

```bash
sudo apt update
sudo apt install python3-pip python3-venv -y
```

Verify Pip is installed correctly:

```bash
pip3 --version
```

The output is similar to:

```bash
__output__pip 24.0 from /usr/lib/python3/dist-packages/pip (python 3.12)
```

It is good practice to manage Python packages through a virtual environment. Create one with the steps below.

```bash
python3 -m venv $HOME/yolo-venv
source $HOME/yolo-venv/bin/activate
```

Your terminal displays `(yolo-venv)` in the prompt indicating the virtual environment is active.

You also need the Git distributed version control system installed.

Run the command below to verify that Git is installed on your system:

```bash
git --version
```

If it is installed, you will see output similar to:

```bash
__output__git version 2.39.3
```

### Install Make

Install the Make build tool, which is used to build the firmware in the next section.

```bash
sudo apt update
sudo apt install make -y
```

After Make is installed, run it to print the version.

```bash
make --version
```

The output is similar to:

```bash
__output__GNU Make 4.3
__output__Built for x86_64-pc-linux-gnu
__output__Copyright (C) 1988-2020 Free Software Foundation, Inc.
__output__License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
__output__This is free software: you are free to change and redistribute it.
__output__There is NO WARRANTY, to the extent permitted by law.
```

> **Note**  
> If you are using macOS, you need to verify that your installation is for GNU Make - not the BSD version. You should see GNU in the version output.

### Install the Arm GNU toolchain

The toolchain is used to compile code on the host for the embedded device architecture.

```bash
cd $HOME
wget https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi.tar.xz
tar -xvf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-eabi.tar.xz
export PATH="$HOME/arm-gnu-toolchain-13.2.Rel1-x86_64-arm-none-eabi/bin/:$PATH"
```

```bash
cd $HOME
wget https://developer.arm.com/-/media/Files/downloads/gnu/13.3.rel1/binrel/arm-gnu-toolchain-13.3.rel1-darwin-arm64-arm-none-eabi.tar.xz
tar -xvf arm-gnu-toolchain-13.3.rel1-darwin-arm64-arm-none-eabi.tar.xz
export PATH="$HOME/arm-gnu-toolchain-13.3.rel1-darwin-arm64-arm-none-eabi/bin/:$PATH"
```

> **Tip**  
> You can add the `export` command to your `.bashrc` or `.zshrc` file to set the search path for each new shell.

Now that your development environment is ready, move to the next section where you will generate the firmware image.