Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt

Use this file to discover all available pages before exploring further.

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.
Connector versions < 3.4.0 require the Speckle Desktop Services background service. Learn more about Desktop Services. For versions ≥ 3.4.0; the desktop service is not required.

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, also 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, also delete the ~/Library/Application Support/Speckle/ folder.

Back to manual installation overview

Return to connector selection
Last modified on April 27, 2026