Skip to main content

Requirements

specklepy requires:
  • Python 3.11 or higher (Python 3.11, 3.12, 3.13, 3.14, 3.15 supported)
specklepy works on Windows, macOS, and Linux.

Install with pip

Install specklepy with the bundle extra:
The bundle extra installs pyarrow, which specklepy needs to load and publish versions with operations.receive3 and operations.send3.
An older specklepy gets a 404 when it loads a version published by a 2026.9 connector. Install 2026.9.0b3 or later with the bundle extra. See Who’s affected.
2026.9.0b3 is a prerelease; a plain pip install specklepy installs 2026.8, which has no operations.receive3. A later stable 2026.9.0 replaces the pin without changing the calls.

Upgrade an existing installation

Run the same command. pip replaces the installed specklepy with 2026.9.0b3. Moving a script from operations.receive to operations.receive3? See Migrate to 2026.9. It’s best practice to use a virtual environment to avoid dependency conflicts.

Verify Installation

Confirm which specklepy version is installed:
You should see specklepy version: 2026.9.0b3. Then check that the modules you need import:
If the last import raises ModuleNotFoundError: No module named 'pyarrow', install specklepy again with the bundle extra.

Dependencies

specklepy automatically installs these dependencies:
You don’t need to install these manually - pip handles them automatically.

Development Installation

If you want to contribute to specklepy or modify the source code refer to the contributing guide.

Next Steps

Now that you have specklepy installed, learn how to authenticate:

Authentication

Set up authentication with Speckle Server
Last modified on November 14, 2026