Skip to main content
This guide is for IT administrators only. If you are a regular user, see our Blender installation guide instead.
Install separately for each version: Repeat these steps for each application version you want to use with Speckle.
All current Speckle Connectors require the Speckle Desktop Services background service. Learn more about Desktop Services.

Windows Installation

Install for a single user

  1. Extract the downloaded ZIP file and locate the bpy_speckle folder.
  2. Copy the bpy_speckle folder.
  3. Navigate to %AppData%\Blender Foundation\Blender\{VERSION}\scripts\addons\
    • Replace {VERSION} with your Blender version (example: 4.5)
    • Create the directory if it doesn’t exist
  4. Paste the bpy_speckle folder into the addons directory.

Install for all users

Use %ProgramFiles%\Blender Foundation\Blender\{VERSION}\scripts\addons\ instead of %AppData%\Blender Foundation\Blender\{VERSION}\scripts\addons\

Update the connector

To update to a new version, download the latest ZIP file and repeat the installation steps above. The new files will replace the existing ones.

Uninstall the connector

Delete the bpy_speckle folder from your installation location. To remove all Speckle products, delete the %AppData%\Speckle\ folder.

macOS Installation

Installing the connector

  1. Open Blender.
  2. Go to Edit > Preferences > Add-ons.
  3. Click the down arrow next to the search box and select Install from Disk.
  4. Select the downloaded ZIP file.
  5. Enable the add-on by checking the box next to Speckle.
The connector is now installed and ready to use.

Update the connector

To update to a new version, download the latest ZIP file and repeat the installation steps above. The new files will replace the existing ones.

Uninstall the connector

  1. Go to Edit > Preferences > Add-ons.
  2. Find Speckle in the add-ons list.
  3. Click the down arrow next to the checkbox and select Remove.
To remove all Speckle products, delete the ~/Library/Application Support/Speckle/ folder.

Disable update notifications

To prevent update checks, contact [email protected] for a file to replace the connector configuration database.

Back to manual installation overview

Return to connector selection
Last modified on March 20, 2026