Peppy Guide

This guide covers the installation of Peppy and introduces you to creating nodes so you can understand how the system operates.

In a hurry? The Quickstart gets a simulated bimanual robot running in your browser in three steps, without writing any code.

Peppy runs on Ubuntu 24.04 or later and the Linux distributions built on it, on Debian 13 or later (x86_64/aarch64, tested on Ubuntu 24.04), on Raspberry Pi OS (64-bit, based on Debian 13 or later), and on macOS (Apple Silicon). Of the Raspberry Pi boards, it runs on the Raspberry Pi 5, the Pi 500 and the Compute Module 5. Other Linux distributions, Fedora and Arch Linux among them, are not supported, and neither are Ubuntu 22.04, Debian 12, 32-bit systems and the older Raspberry Pi boards: the installer stops on them before it changes anything.

LLM-friendly versions of this documentation are available at /llms.txt and /llms-full.txt.