Wendy LogoWendy
Installation

Developer Machine Setup

Set up your development machine with the Wendy CLI

System Compatibility

Wendy is quickly rolling out support for all major platforms, but at the moment, the experience requires the following:

TypePlatform/HardwareStatus
PlatformmacOS✓ Supported
Linux✓ Supported
WindowsComing Soon
HardwareNVIDIA Jetson✓ Supported
Raspberry Pi 5✓ Supported
Raspberry Pi 3/4Experimental

CLI Installation

Install the Wendy CLI using the package manager for your OS.

Once you have Homebrew installed, update it to ensure you have the latest version, then install the Wendy CLI:

brew upgrade
brew install wendylabsinc/tap/wendy
echo "deb [trusted=yes] https://us-central1-apt.pkg.dev/projects/cloud-c7e56 wendy-apt main" | sudo tee /etc/apt/sources.list.d/wendy.list
sudo apt-get update
sudo apt-get install -y wendy
sudo tee /etc/yum.repos.d/wendy.repo << EOF
[wendy]
name=Wendy CLI Repository
baseurl=https://us-central1-yum.pkg.dev/projects/cloud-c7e56/wendy-yum
enabled=1
gpgcheck=0
EOF
sudo yum makecache
sudo yum install -y wendy

If you use dnf, replace the last two lines with:

sudo dnf makecache
sudo dnf install -y wendy
yay -S wendy

Or with paru:

paru -S wendy

The wendy CLI is your developer tool that helps build, discover, and deploy apps to WendyOS. It can even help get WendyOS setup on your NVIDIA Jetson and Raspberry Pi 5.

Verify the installation:

wendy --version

CLI Commands Overview

After installing the Wendy CLI, you have access to these main commands:

CommandDescription
wendy runBuild, push, and start your app on a device
wendy buildBuild and push your app without starting it
wendy device apps listList apps installed on a device
wendy device apps start <app>Start an installed app
wendy device apps stop <app>Stop a running app

Most developers will use wendy run for day-to-day development. Use wendy build when you want to prepare an app without immediately running it, such as in CI/CD pipelines or when deploying multiple apps at once.

Install Python

WendyOS supports Python for building applications. We recommend using uv to manage Python installations and dependencies.

Install uv

uv is a fast Python package installer and resolver, written in Rust. It's significantly faster than pip and provides better dependency resolution.

curl -LsSf https://astral.sh/uv/install.sh | sh

After installation, restart your terminal or run:

source $HOME/.cargo/env
curl -LsSf https://astral.sh/uv/install.sh | sh

After installation, restart your terminal or run:

source $HOME/.cargo/env
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Restart your terminal after installation.

Verify the installation:

uv --version

Install Python 3.14

Use uv to install Python 3.14:

uv python install 3.14

Set Python 3.14 as your default version:

uv python pin 3.14

Verify the installation:

uv run python --version

You should see Python 3.14.x in the output.

uv Benefits: uv provides 10-100x faster package installation compared to pip, better dependency resolution, and automatic virtual environment management. It's the recommended way to manage Python for WendyOS development.

Docker Installation

WendyOS uses containerd underneath the hood to run applications in containers. Docker is required for building and deploying applications written in all languages, including Swift, Python, Rust, C++, and TypeScript.

Download Docker Desktop

Download Docker Desktop for Mac (Apple Silicon)

Or Install via Homebrew (CLI)

brew install --cask docker

After installation, open Docker from your Applications folder to complete the setup.

System Requirements

  • macOS Monterey (12) or later
  • Apple Silicon (M1, M2, M3, M4, M5, etc...) processor
  • At least 4GB RAM (8GB recommended)

Download Docker Desktop

Download Docker Desktop for Linux (DEB)

Download Docker Desktop for Linux (RPM)

Or Install via CLI (Ubuntu/Debian)

Set up Docker's apt repository and install Docker Engine:

# Remove conflicting packages
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

# Set up Docker repository
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add Docker repository
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker Engine
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Start Docker:

sudo systemctl start docker
sudo systemctl enable docker

Other Linux Distributions

For Fedora, CentOS, RHEL, and other distributions, visit the official Docker documentation.

Download Docker Desktop

Download Docker Desktop for Windows

Or Install via CLI (Winget)

winget install Docker.DockerDesktop

System Requirements

  • Windows 10 or 11 (64-bit)
  • WSL 2 feature enabled
  • At least 4GB RAM (8GB recommended)

After installation, enable WSL 2 when prompted to allow Linux containers, restart your PC, and launch Docker Desktop from the Start menu.

Verify the installation:

docker --version

We recommend using the latest stable version of Docker (v27.5 or later as of early 2025).

Next Steps

Once you have the Wendy CLI installed, you can proceed to install WendyOS on your device:

Overview

Complete guide to Wendy - the modern Physical AI operating system

NVIDIA Jetson Installation

Install WendyOS on your NVIDIA Jetson device