Issues | Windows
Learn about what troubleshooting steps to take if the Pieces Desktop App isn’t working as expected on your Windows issues.
Alternative Installation Methods
If you’re experiencing difficulties with installing Pieces Desktop App, you can install the software manually by downloading the Windows installer.
You can also install Pieces for Developers manually using WinGet from your device’s terminal.
To do so:
-
Launch Windows Terminal, Command Prompt, or PowerShell as administrator.
-
In the terminal, type
winget install “Pieces for Developers”and pressenter.
You may be prompted to enter Y or N to agree or disagree the terms of use when installing the Pieces Desktop App—type and enter Y to proceed with the installation.
Versions & Updates
Many issues can stem from out-of-date plugins, extensions, or the Desktop App itself.
Updating the Pieces Desktop App
Updating the Pieces Desktop App on Windows (and macOS) can be done directly within the application:
Open the Pieces Desktop App
Press the Windows Icon and search for Pieces Desktop, open it
Locate the User Icon
Click the User Icon to the right of the Search Bar at the top of the main app view
Check for Updates
Select Check for Desktop App Updates
Update Pieces for Developers
If prompted, click Download Update to 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:
Open your Settings
Click the Start button, then select Settings.
Find your Updates
Click Windows Update in the sidebar options.
Install any Updates
Install any pending updates and restart your computer.
Updating the Microsoft Store & App Installer
Open the Microsoft Store
Press the Windows button and search for the Microsoft Store, open it.
Find the Library updates
Click on Library to check for available updates.
Update all recommendations
Update the Microsoft Store and the App Installer if prompted.
Reinstall Pieces Suite
Now, you can retry installing Pieces Suite.
Checking Hardware Specifications
You might need to check your system's specifications if you keep having issues, especially when trying to use local LLMs.
To check your device specifications on Windows:
Open the Windows search
Press the Windows key on your keyboard or the Windows Icon in the task bar
Open Run
Type “run” and press enter
Find Dxdiag
Type dxdiag and press enter 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).
Checking Windows Version
If the Pieces Installer isn't working properly, you might be using an outdated version of Windows. Pieces requires at least Windows 10 v.1809 or higher.
To find out your Windows version, press the Windows and R keys together, type winver in the pop-up window, and press Enter.
A new window will open called About Windows, which will display your current windows version.
If this doesn't work, you’re likely using a Windows version lower than Windows 10.
Restart the Pieces Desktop App
After trying any of the fixes above, it’s recommended to restart you desktop and to restart Pieces Desktop App. This ensures all caches are clean and the computer is refreshed.
If the problem persists, please open a GitHub issue for further assistance, or book a call with our engineers.