DMG Installation (Recommended)

The DMG installer is the recommended method for installing Pieces on macOS. Choose the correct version for your Mac's processor.

*For M1, M2, M3, M4 Macs* 
macOS 13.0 (Ventura) or higher required.
*For pre-2020 Macs* 
macOS 13.0 (Ventura) or higher required.
PiecesOS is a required Core Dependency. After you move Pieces Desktop to your Applications folder and open it for the first time, you'll be guided through installing PiecesOS automatically.

Install the DMG

Open your **Downloads** folder (or wherever you saved the installer) and look for the `.dmg` file you just downloaded (e.g., `Pieces.dmg`). Double-click the `.dmg` file to mount it. Drag the application icon from the mounted `.dmg` window into your **Applications** folder. Go back to **Finder**, right-click the mounted image, and select **Eject** to unmount it. Put Pieces in **Applications** or another **local** folder—not **iCloud Drive** or other synced locations.

System Requirements

Component Minimum Recommended Notes
OS Version macOS 13.0 (Ventura) macOS 14.0 or higher Apple Silicon or Intel processor.
CPU Any modern CPU Multi-core CPU Avoid dual-core processors—aim for at least a 4-core CPU.
RAM (Local Mode) 8 GB total system RAM with 2 GB free 16 GB total system RAM or more Applies when PiecesOS is running locally.
RAM (Cloud Mode) 8 GB total system RAM with 1 GB free 16 GB total system RAM or more Applies when PiecesOS is running in cloud mode.
Disk Space 2 GB minimum (1 GB for PiecesOS + 0.5–1 GB for data), with at least 4 GB free 8 GB with at least 6 GB free or more Ensure additional free space for data storage and future growth.

Click here for a quick guide on determining your OS type, and here for how to check your device's CPU architecture.

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 macOS troubleshooting for common solutions.