Speckle | specklepy 🐍
Speckle is the first AEC data hub that connects with your favorite AEC tools. Speckle exists to overcome the challenges of working in a fragmented industry where communication, creative workflows, and the exchange of data are often hindered by siloed software and processes. It is here to make the industry better.
The Python SDK
Repo structure
Usage
Send and receive data from a Speckle Server with operations, interact with the Speckle API with the SpeckleClient, create and extend your own custom Speckle Objects with Base, and more!
Head to the 📚 specklepy docs for more information and usage examples.
Developing & Debugging
Installation
This project uses uv for dependency management, make sure you follow the official docs to get it.
To create a new virtual environment with uv run $ uv venv and follow the instructions on the screen to activate the virtual environment.
To bootstrap the project environment run $ uv sync. This will install both the package and dev dependencies.
To execute any python script run $ uv run python my_script.py
Alternatively you may roll your own virtual-env with either venv, virtualenv, pyenv-virtualenv etc. Uv will play along an recognize if it is invoked from inside a virtual environment.
Style guide
All our repo wide styling linting and other rules are checked and enforced by pre-commit, which is included in the dev dependencies.
It is recommended to set up pre-commit after installing the dependencies by running $ pre-commit install.
Commiting code that doesn't adhere to the given rules, will fail the checks in our CI system.
Local Data Paths
It may be helpful to know where the local accounts and object cache dbs are stored. Depending on on your OS, you can find the dbs at:
- Windows:
APPDATAor<USER>\AppData\Roaming\Speckle - Linux:
$XDG_DATA_HOMEor by default~/.local/share/Speckle - Mac:
~/.config/Speckle
Contributing
Please make sure you read the contribution guidelines and code of conduct for an overview of the practices we try to follow.
Community
The Speckle Community hangs out on the forum, do join and introduce yourself & feel free to ask us questions!
Security
For any security vulnerabilities or concerns, please contact us directly at security[at]speckle.systems.
License
Unless otherwise described, the code in this repository is licensed under the Apache-2.0 License. Please note that some modules, extensions or code herein might be otherwise licensed. This is indicated either in the root of the containing folder under a different license file, or in the respective file's header. If you have any questions, don't hesitate to get in touch with us via email.
1 maintainer
Metadata
1 maintainer
Release files for specklepy 2026.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| specklepy-2026.8.1.tar.gz | 104.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| specklepy-2026.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 262.3 kB
Release files / specklepy-2026.8.1.tar.gz
| Download URL | specklepy-2026.8.1.tar.gz |
|---|---|
| Size | 104.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d0d1c56b09b06b3f744879f7cf27b3495977cef010435f8850f4e1eb4d38263a
|
|
BLAKE2b-256 checksum How to use checksums |
f07e3fd04e1522c7e25ba2838cc8e9e28bfff4963568966d7fe44984242be405
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / specklepy-2026.8.1-py3-none-any.whl
| Download URL | specklepy-2026.8.1-py3-none-any.whl |
|---|---|
| Size | 158.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1fd6e4709953195c29d07924fa6d23ae3e84f0aeb7081da5d3e664657d915577
|
|
BLAKE2b-256 checksum How to use checksums |
66e5e3c192cb265702e4394f14f1dd444a1dc4ae385d07a8ef8c274c96daa4ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
