COMPAS Timber
compas_timber is a user-friendly open-source software toolkit that streamlines the design-to-fabrication workflow of timber frame structures. A project is designed and refined in a single digital model that also produces the manufacturing data, so it can go from first concept to fabrication without re-modeling or back-and-forth rework along the way. By lowering the threshold for creating versatile and resource-aware timber designs, we aim to increase the use of timber in architecture.
Installation
We recommend managing environments and dependencies with uv, but a plain pip install compas_timber works just as well.
Add compas_timber to your project:
uv add compas_timber
To visualize models outside of Rhino, install with the viz extra, which adds compas_viewer and compas_brep[occ]:
uv add "compas_timber[viz]"
For a development setup, clone the repository and sync the environment:
git clone https://github.com/gramaziokohler/compas_timber.git
cd compas_timber
uv sync --extra dev
uv run pytest
First Steps
- Documentation
- COMPAS TIMBER Grasshopper Plugin (timber_design)
- COMPAS TIMBER Grasshopper Tutorial
- COMPAS TIMBER API Reference
Questions and feedback
We encourage the use of the COMPAS framework forum for questions and discussions.
Issue tracker
If you found an issue or have a suggestion for a dandy new feature, please file a new issue in our issue tracker.
Contributing
We love contributions!
Check the Contributor's Guide for more details.
Credits
compas_timber is currently developed by Gramazio Kohler Research. See CITATION.cff for a complete list of authors.
1 maintainer
Metadata
1 maintainer
Release files for compas-timber 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| compas_timber-3.0.0.tar.gz | 250.3 kB | With provenance | Details for compas_timber-3.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| compas_timber-3.0.0-py3-none-any.whl | Python 3 | none | any | Details for compas_timber-3.0.0-py3-none-any.whl |
Total release size: 568.0 kB
Release files / compas_timber-3.0.0.tar.gz
| Download URL | compas_timber-3.0.0.tar.gz |
|---|---|
| Size | 250.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bdd8cc84dfc5275d1a7ed29629fd5c1c07c090b8e560644dd807aafab02c001d
|
|
BLAKE2b-256 checksum How to use checksums |
b65585f938f9bbe30d02c0cd2ada4bf3d31fc52bc6b322e1767c398216e68575
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.
Transparency logRelease files / compas_timber-3.0.0-py3-none-any.whl
| Download URL | compas_timber-3.0.0-py3-none-any.whl |
|---|---|
| Size | 317.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9b98f21d9ce931272b72359d218e654e9362dfdf8d403ac519fb27a16547aae1
|
|
BLAKE2b-256 checksum How to use checksums |
4e829684469e140ff4027e89a992bd9bcf27e8ab33060bdc15d202dcf3ca4ebb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.
Transparency logSecurity for compas-timber 3.0.0
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for compas_timber-3.0.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.
Transparency logA 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.
