Prerequisites

Table of Contents

1. Common Prerequisites

2. Windows Installation

3. macOS Installation

4. Linux Installation

5. Raspberry Pi5 OS Installation

Common Prerequisites

1. Python

• Required Version: 3.9 ~ 3.13 (>=3.9,<3.14)

• If not installed or needs an update, download and install from the official Python website.

Python Official Website

2. uv

• Required: uv is a Python package installer and environment manager

• Install with the following command: pip install uv

• Verify installation: Run uv --version in the terminal

uv Official Website

3. Node.js

• Required Version: 18 or higher

• Check installation: Run node --version in the terminal (ensure it outputs 18.x or higher)

Windows Installation

1. Download the latest version (v18 or higher) from the Node.js official website.
2. Run the installer and follow the instructions.

3. Verify installation: Run node --version in the command prompt.

macOS Installation

1. Download the latest version (v18 or higher) from the Node.js official website.
2. Run the installer and follow the instructions.

3. Verify installation: Run node --version in the terminal.

Alternatively, install using Homebrew:

brew install node

Linux Installation

1. Install Node.js using nvm (Node Version Manager):

sudo apt update
sudo apt install curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

1. Verify installation: Run node --version in the terminal (ensure it outputs 18.x or higher)

Raspberry Pi5 OS Installation

1. Follow the general Linux installation process:

sudo apt update
sudo apt install curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

1. Verify installation: Run node --version in the terminal (ensure it outputs 18.x or higher)

2. Additionally, run the following commands to create symbolic links for the required libraries:

sudo ln -s /usr/lib/aarch64-linux-gnu/libwebp.so.7 /usr/lib/aarch64-linux-gnu/libwebp.so.6
sudo ln -s /usr/lib/aarch64-linux-gnu/libtiff.so.6 /usr/lib/aarch64-linux-gnu/libtiff.so.5

These commands create symbolic links for the library versions required for Pyloid to function correctly on Raspberry Pi5 OS.