---

Issues | Windows

Learn about what troubleshooting steps to take if PiecesOS or the Pieces Desktop App isn’t working as expected on your Windows issues.

---

Manual Installation Methods

If you’re experiencing difficulties with installing PiecesOS or the Pieces Desktop App, you can install both softwares manually by downloading the standalone .exe or .msix files.

via EXE Files

You can download the individual .exe files for PiecesOS and the Pieces Desktop App by clicking the download links below.

---

---

via MSIX

For an alternative to the .exe method, you can use the .msix (innosetup) standalone installation files for PiecesOS and the Pieces Desktop App.

---

---

Uninstalling

You can uninstall PiecesOS or the Pieces Desktop App from the Windows Settings application, regardless if you installed via .exe, .appinstaller or with a winget command.

via Windows Settings

To uninstall Pieces software products using the Windows Settings application:

1. Open Settings, then navigate to or search for Apps.

2. Click Installed Apps.

3. Type “Pieces”.

To uninstall Pieces Desktop, PiecesOS or Pieces Suite, click the three dots to the right of the application’s name and click Uninstall.

via Terminal

You can also uninstall PiecesOS or the Pieces Desktop App through your terminal:

1. PiecesOS: Open your terminal, type winget uninstall “Pieces OS” and press enter.

2. Pieces Desktop App: Open your terminal, type winget uninstall “Pieces Desktop” and press enter.

Versions & Updates

Many issues can stem from out-of-date plugins, extensions, the desktop app, or PiecesOS itself.

Updating PiecesOS

To restart and check for updates to PiecesOS on Windows:

1. Locate the Pieces Icon (P) in your taskbar

2. Click the icon to view your update status

3. If an update is available, follow the on-screen prompt to download and install it.

For standalone .EXE installations, updates are checked daily or upon application launch, prompting you to install or delay as needed.

Updating the Pieces Desktop App

Updating the Pieces Desktop App on Windows (and macOS) can be done directly within the application:

1. Open the Pieces Desktop App

2. Click the User Icon to the right of the Search Bar at the top of the main app view

3. Select Check for Desktop App Updates

4. If prompted, click Download Update install available updates

You can also select Check for PiecesOS Updates from the same menu as an alternative to doing so from the PiecesOS system window in your taskbar.

Common Installation Issues

Windows users may encounter installation issues for various reasons, such as out-of-date OS components or incomplete dependencies.

Checking for Windows Updates

Before installing, ensure your Windows system is fully updated:

1. Click the Start button, then select Settings

2. Click Windows Update

3. Install any pending updates and restart your computer

Updating the Microsoft Store & App Installer

1. Open the Microsoft Store

2. Click on Library to check for available updates

3. Update the Microsoft Store and the App Installer if prompted

4. Retry installing the Pieces Suite

Checking Hardware Specifications

It may be necessary to verify your system’s specifications if you experience ongoing issues, especially when attempting to utilize local LLMs.

To check your device specifications on Windows:

• Press the Windows key on your keyboard, or the Windows icon in the task bar

• Type run and hit enter

• Type dxdiag and press enter on, or click, the blue OK button

The System tab will display your processor, number of CPU cores, and memory (RAM), while the Display tab will list your GPU, it’s maker (NVIDIA, AMD, Intel, etc.) and the available video memory (VRAM).

Read documentation on minimum recommended hardware specifications across all OS platforms.

Checking Windows Version

If the Pieces Installer is not working as intended, you could have an outdated version of Windows. The minimum Windows version that Pieces will run on is Windows 10 v.1809 or higher.

To check what version of Windows you’re running:

• Press the Windows and the R keys simultaneously on your keyboard

• A new window will pop-up, type winver and press Enter

A new window will open called About Windows, which will display your current windows version.

Restart & Retry

If the problem persists, please open a GitHub issue for further assistance, or book a call with our engineers.