Skip to main content


Speckle | specklepy 🐍

Twitter Follow Community forum users website docs

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

PyPI - Version Codecov License

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: APPDATA or <USER>\AppData\Roaming\Speckle
  • Linux: $XDG_DATA_HOME or 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.

Metadata

Release files for specklepy 2026.9.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for specklepy 2026.9.1
File Size Uploaded Provenance Actions
specklepy-2026.9.1.tar.gz 163.4 kB Without provenance Details for specklepy-2026.9.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for specklepy 2026.9.1
File Interpreter ABI Platform Actions
specklepy-2026.9.1-py3-none-any.whl Python 3 none any Details for specklepy-2026.9.1-py3-none-any.whl

Total release size: 391.6 kB

Release files / specklepy-2026.9.1.tar.gz

Download URL specklepy-2026.9.1.tar.gz
Size 163.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8d811ee15286876e31a4b3b26d7e94b63555bd80474341022b186e5850426c43
BLAKE2b-256 checksum
How to use checksums
b1ffa71afa44d24273bf850b732ad26c6f559c955eaa6810315a19772dcfa0a0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","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.9.1-py3-none-any.whl

Download URL specklepy-2026.9.1-py3-none-any.whl
Size 228.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b72722190e4043a5dcdc065dcc878329bb0bf6f152a7b9b7bae93ad63abc23c0
BLAKE2b-256 checksum
How to use checksums
854941f713d451d7b0352deadcb035e0c6ee5c4ac4645f71fb46e2d03174728c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","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}

Security for specklepy 2026.9.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2026.9.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page