Before You Begin

python3 --version
# Target: Python 3.13.x

# Ubuntu 24.04 ships Python 3.12 by default.
# Add the deadsnakes PPA to get 3.13:
sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.13 python3.13-venv python3.13-dev python3-pip

# Make 3.13 the default python3
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.13 1
python3 --version   # Python 3.13.x

python --version
# Python 3.13.x

pip --version
# pip 24.x from C:\...\Python313\...

# Option A: Homebrew (recommended)
brew install python@3.13
echo 'export PATH="$(brew --prefix python@3.13)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
python3 --version  # Python 3.13.x

# Option B: Official installer
# Download from python.org/downloads → macOS installer

# Create
python3 -m venv .venv

# Activate — Linux / macOS
source .venv/bin/activate

# Activate — Windows PowerShell
.venv\Scripts\Activate.ps1

# Your prompt changes:
# (.venv) $

# Install packages (no sudo needed)
pip install numpy pandas scikit-learn tensorflow

# Save dependencies
pip freeze > requirements.txt

# Deactivate
deactivate

git --version
# git version 2.x.x

sudo apt update && sudo apt install -y git git-lfs
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

git --version  # git version 2.x.x

# macOS will auto-prompt to install Xcode Command Line Tools when you run:
git --version
# Click "Install" on the dialog, or run:
xcode-select --install

git config --global user.name  "Your Name"
git config --global user.email "you@example.com"
git config --global core.editor "code --wait"   # VS Code as default editor
git config --global init.defaultBranch main
git config --global pull.rebase false

# Verify
git config --list

# Before plugging in the board
ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null

# Plug in the board, then run again — a new entry should appear
ls /dev/ttyUSB* /dev/ttyACM* 2>/dev/null
# /dev/ttyUSB0

# If you get "Permission denied":
sudo usermod -aG dialout $USER
# Log out and back in for the group change to take effect

# Watch the kernel detect the board live:
dmesg | tail -10
# [ 4523.192] cp210x converter now attached to ttyUSB0

ls /dev/cu.*
# /dev/cu.usbserial-0001   (CP2102/FTDI)
# /dev/cu.SLAB_USBtoUART   (CP2104)
# /dev/cu.wchusbserial14310 (CH340)

sudo snap install code --classic
code --version

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" \
    | sudo tee /etc/apt/sources.list.d/vscode.list
sudo apt update && sudo apt install -y code

Ctrl+Shift+X  →  Search and install:

code --install-extension ms-vscode.cpptools
code --install-extension ms-vscode.cmake-tools
code --install-extension espressif.esp-idf-extension
code --install-extension ms-python.python
code --install-extension ms-python.pylance
code --install-extension ms-vscode.serial-monitor
code --install-extension eamodio.gitlens
code --install-extension ms-vscode-remote.remote-ssh
code --install-extension ms-azuretools.vscode-docker

sudo apt update
sudo apt install -y \
  build-essential \
  gcc \
  g++ \
  make \
  cmake \
  ninja-build \
  pkg-config \
  libssl-dev \
  libffi-dev \
  libusb-1.0-0-dev \
  gdb \
  openocd

# Install Homebrew if not present
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install build tools
brew install cmake ninja gcc openssl libusb pkg-config

winget install --id Kitware.CMake
winget install --id Ninja-build.Ninja
winget install --id GnuWin32.Make

python3 --version          # Python 3.13.x
pip --version              # pip 24.x
git --version              # git 2.x.x
cmake --version            # cmake 3.x.x
ninja --version            # 1.x.x
gcc --version              # gcc x.x.x
code --version             # 1.x.x (if VS Code is in PATH)