Snap Installation (Recommended for Ubuntu)

Snap is the recommended installation method for Ubuntu users. It provides automatic updates, system integration, and simple management through terminal commands.

Snap Requirements

  • Snap Support: Ensure snapd is installed and enabled. Most Ubuntu releases include it by default.
  • Administrator Access: You'll need sudo privileges to install snap packages.
  • Ubuntu 22.04+ or a compatible distribution with Snap support.

Install via Snap

*Ubuntu 22.04+ required.*

Run these commands in order to install and properly set up the Pieces Desktop App and its core dependencies:

  1. sudo snap install pieces-os

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

  3. sudo snap install pieces-for-developers

Then, type pieces-for-developers to launch the application directly from your terminal.

Click here for documentation on determining your OS version.

Connect System Interfaces

After installing via Snap, run pieces-os.doctor in your terminal. The script outputs a command you can copy and paste to connect all interfaces with the system. This step is required for full functionality, including features like LTM Audio.

Updating

The Pieces Desktop App automatically downloads and installs new updates.

You can also manually check for updates by hovering over your username in the top left, then hovering over Update and selecting either Check for Desktop App Updates or Check for PiecesOS Updates.

Checking for PiecesOS updates in the Pieces Desktop App on Linux

Uninstalling

You can uninstall PiecesOS and the Pieces Desktop App using snap commands directly from your terminal.

When running these commands, you will be prompted to enter your device's local account password due to the `sudo` command. `sudo snap remove pieces-for-developers` `sudo snap remove pieces-os`

Next Steps

After installation, explore Conversational Search to start chatting with your memories, or configure Long-Term Memory to customize how Pieces captures your workflow context.

If you encounter issues, see Linux troubleshooting for common solutions.