Explore
References are complete, ready-to-build example projects that demonstrate how to use Avocado OS with different languages, frameworks, and hardware targets. Each reference includes an avocado.yaml, application source, build scripts, and a getting started guide. Use avocado init --reference to scaffold a new project from any reference:
avocado init --reference python-mqtt my-project
C GPIO Toggle
A reference runtime that demonstrates how to cross-compile a C application using the Meson build system in the Avocado SDK. The app uses libgpiod v2 to enumerate GPIO chips, request a line for output, and toggle it every second.
C++ CMake Syslog Dashboard
A reference runtime that demonstrates how to build a C++ application with CMake and third-party libraries fetched at build time as an Avocado OS extension. The app renders a live terminal dashboard of the system journal using FTXUI.
Dev Starter
A minimal reference runtime that boots Avocado OS with development tools, SSH access, and i2c-tools pre-installed. No application code or build scripts — just a blank canvas to start building on.
Elixir Phoenix
A reference runtime that demonstrates how to build and deploy an Elixir Phoenix LiveView application as an Avocado OS extension. The app is compiled as an OTP release inside the SDK container and displayed on-device via the Cog WebKit browser.
ICAM-540 Dev
A development runtime for the Advantech ICAM-540 with Basler Pylon camera SDK, GStreamer pipelines (including NVIDIA hardware encode/decode), OpenCV, and hardware debugging tools pre-installed. No application code — a ready-to-use environment for camera and vision development.
Java Hello World
A reference runtime that demonstrates how to compile and run a Java application as an Avocado OS extension. The app is compiled with `javac` and packaged as an executable JAR inside the SDK container using OpenJDK 17.
Custom Linux Kernel
A reference runtime that demonstrates how to cross-compile a custom Linux kernel from source using the Avocado SDK and boot it on QEMU. Replaces the default kernel provided by the `avocado-runtime` meta-package with a from-source build of Linux 6.12.69.
Node.js Dashboard
A reference runtime that demonstrates how to build a Node.js web application as an Avocado OS extension and display it on-device via the Cog WebKit browser. The app serves a real-time device dashboard and JSON API using Express, with all metrics read directly from `/proc` and `/sys`.
Python Flask Dashboard
A reference runtime that demonstrates how to build a Python Flask web application as an Avocado OS extension. The app serves a real-time device dashboard that displays CPU, memory, disk, network, and temperature metrics, along with a JSON API for programmatic access.
Python GStreamer YOLO Object Detection
A reference runtime that demonstrates real-time object detection on an NVIDIA Jetson Orin Nano using a USB (UVC) camera, GStreamer, and YOLO11 with GPU-accelerated inference via OpenCV DNN and CUDA. The app serves the annotated video feed as an MJPEG stream with a web dashboard.
Python MQTT Telemetry
A reference runtime that demonstrates how to build a Python application with pip dependencies as an Avocado OS extension. The app collects device telemetry (uptime, memory, CPU load, temperature) and publishes it over MQTT to a public broker, using the device's systemd machine ID as a stable, unique identifier.
Whisper Speech-to-Text
A reference runtime that runs OpenAI's Whisper speech-to-text model locally on a Raspberry Pi 5 with a USB microphone. The app continuously records audio, transcribes it on-device, and logs structured JSON results to the journal. No cloud API calls required.
QEMU Quickstart (Experimental)
A minimal reference runtime that boots Avocado OS in QEMU with Avocado Connect and Tunnels pre-configured for remote device management. No application code or build steps — the fastest path to a running Avocado OS instance with cloud connectivity.
React Dashboard
A reference runtime that demonstrates how to build and deploy a React.js system monitoring dashboard on Avocado OS. The app is a full-stack web application — a Vite-built React frontend with Tailwind CSS served by an Express.js backend that reads system metrics from `/proc` and `/sys`.
Rubicon
A full-featured development runtime for Raspberry Pi 4 and 5 with USB gadget networking, WiFi, Docker, Cockpit web management, and multi-arch container support via QEMU user-static. Connect to your Pi over USB-C with zero network configuration.
Rust System Vitals (Experimental)
A reference runtime that demonstrates how to cross-compile and deploy a Rust application on Avocado OS. The app is a system vitals reporter — a single static binary that reads from `/proc` and logs structured JSON to the journal. No runtime, no interpreter, no dependencies on the device.
