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 thebundle extra:
bundle extra installs pyarrow, which specklepy needs to load and publish versions with operations.receive3 and operations.send3.
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 fromoperations.receive to operations.receive3? See Migrate to 2026.9.
Virtual Environments (Recommended)
It’s best practice to use a virtual environment to avoid dependency conflicts.- uv (Recommended)
- venv (Built-in)
- conda
Verify Installation
Confirm which specklepy version is installed:specklepy version: 2026.9.0b3. Then check that the modules you need import:
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