Skip to main content

Getting Started with Pieces for Developers on Linux

Compatible with Ubuntu 22 or higher and select distributions

A robot checking the install for pieces desktop for linux.

To run Pieces for Developers on Linux, be sure to download both of the applications from the Snap Store before installing. You can also follow the instructions below these install buttons to install via terminal.

Install Pieces for Developers
Install Pieces OS

If you are utilizing a Linux Distribution that is not encompassed within our Verified Support list, we unfortunately cannot ensure the complete functionality of all components within the Pieces for Developers Suite at this time. Should you encounter any challenges, we kindly request that you reach out to us at here for assistance.

Supported Linux Distributions

Currently tested and supported Linux distributions that can be used with Pieces for Developers:

  • Ubuntu 22+
  • Ubuntu-based distros

Steps to Install

  1. To install from your terminal run the following:

    sudo snap install pieces-os

    Save to Pieces

  2. Enable Offline and On-Device Local Machine Learning by running the following command in the terminal:

    sudo snap connect pieces-os:process-control :process-control

    Save to Pieces

    This command sets up and configures local application interfaces to properly load our Sand-boxed and Secure Machine Learning Models.

  3. Install the Pieces Desktop Snap:

    sudo snap install pieces-for-developers

    Save to Pieces

  4. Launch Pieces OS by running the following command in your terminal:


    Save to Pieces

  5. Launch the Pieces for Developers Desktop App by running the following command in your terminal:


    Save to Pieces


Check out our YouTube Channel for more information on Getting Started.

Helpful Tips for Linux

Updating your Application

To update your application, you can either:

Update individual snap packages one at a time:

  1. Update the Pieces Desktop Snap
sudo snap refresh pieces-for-developers
  1. Update the Pieces OS Snap
sudo snap refresh pieces-os


Update all snap packages at once:

sudo snap refresh

This will update other snap packages that you have installed, so be sure before you run this command.