When to Install Manually

PiecesOS installs automatically with the Pieces Desktop App. Install it manually if you want to use Pieces MCP integrations without the full Desktop experience—LTM, Conversational Search, and MCP features still work.

System Requirements

Minimum Recommended Notes
Any modern CPU Multi-core CPU PiecesOS supports multithreading
8 GB RAM 16 GB+ RAM 1 GB free (cloud mode) or 2 GB free (local mode)
6 GB storage 10 GB+ storage ~2 GB for PiecesOS + at least 4 GB for LTM data

Minimum OS Versions

macOS Windows Linux
macOS 12.0 (Monterey)+ Windows 10 (v.1809)+ Ubuntu 22+
Need help checking your specs or OS version? See [Troubleshooting](/products/core-dependencies/pieces-os/troubleshooting#checking-system-specifications).

Windows

*Windows 10 (1809) or higher* *Windows 10 (1809) or higher* **Installation path:** Avoid **OneDrive**, **iCloud Drive**, and other cloud-synced locations—use a local drive (the default path is recommended).

macOS

*macOS 12.0 (Monterey) or higher* *macOS 12.0 (Monterey) or higher*

Installing via Homebrew

brew install --cask pieces-os

Linux

PiecesOS on Linux requires **Ubuntu 22+** and **snapd** enabled on your system. Press `ctrl+alt+t` to open your terminal. Run `sudo snap install pieces-os` and enter your password when prompted. Run `sudo snap connect pieces-os:process-control :process-control` to enable on-device machine learning and LLM functionality. Type `pieces-os` and press Enter.

Uninstalling PiecesOS

Open **Finder** > **Applications**. Find `PiecesOS`, right-click, and select `Move to Trash`. 
<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/meet_pieces_assets/meet_pieces/get_started/macos/macos_how_to_uninstall_pfd.gif" alt="Uninstalling PiecesOS from macOS Applications folder" align="center" fullwidth="true" />
Open **Settings** > **Apps**, search for `Pieces`. Click the three dots next to PiecesOS and select `Uninstall`. 
<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/meet_pieces_assets/meet_pieces/get_started/windows/uninstalling_on_windows.gif" alt="Uninstalling PiecesOS from Windows Settings" align="center" fullwidth="true" />
Run `sudo snap remove pieces-os` in your terminal. 
<Image src="https://storage.googleapis.com/hashnode_product_documentation_assets/meet_pieces_assets/meet_pieces/get_started_linux/uninstall_pfd_from_terminal.png" alt="Uninstalling PiecesOS from the Linux terminal" align="center" fullwidth="true" />

Having trouble? See Troubleshooting PiecesOS or visit the Support page.