Skip to main content

Open Source

Avocado OS is built in the open. The OS and its tooling are developed on GitHub under the avocado-linux organization, so you can read the source, file issues, and contribute. The best place to start is the core OS repository:

  • avocado-os — The core Avocado OS distribution and its built extensions. Start here.

From there, explore the rest of the ecosystem:

  • avocado-cli — The avocado command-line tool for building, provisioning, and deploying.
  • references — Example projects and reference configurations for working with Avocado OS.
  • meta-avocado — The Avocado distro layer for Yocto.
  • avocadoctl — On-device runtime control and commands.
  • avocado-mcp — The MCP server that turns your AI assistant into an Avocado OS co-pilot.
  • stone — A CLI for managing Avocado stones.
  • docs — The source for these documentation pages (under the peridio organization).
Pull requests welcome!

Found a bug, a typo, or have an improvement in mind? We'd love your contributions. Open an issue or send a PR on any of these repos — and if you're not sure where to start, join our Discord and we'll happily point you in the right direction.