OpenConstruction Tools
Find and compare construction datasets, models, and other AEC resources. Use the CLI in your terminal or connect an MCP client.
Install
Requires Python 3.11 or newer. Once version 0.1.0 is published on PyPI:
pip install openconstruction-tools
Use the CLI
openconstruction search "hardhat" --type dataset
openconstruction show dataset CHVG
openconstruction download CHVG
The download command asks you to review the dataset license and confirm.
Files are saved under ~/.openconstruction/datasets. For scripts, review the
terms first, then pass --accept-license. Run openconstruction --help
for more commands.
Public Zenodo and Figshare records and declared direct file links support downloads. Hugging Face and GitHub require a catalog-declared download route; Google Drive and other unsupported or restricted sources require the provider's own access workflow. Provider credentials remain local.
Connect MCP
For the hosted service, add this HTTP endpoint to your MCP client and sign in to OpenConstruction when prompted. No Python installation is needed:
https://mcp.openconstruction.org/mcp
For local MCP, install this package and configure your client to launch
openconstruction-mcp over stdio. Then ask:
Download the OpenConstruction dataset "CHVG".
Review the license and confirm before downloading. Local MCP saves files on your computer; remote MCP returns supported public file links for your client to save. A client without file-download support can display those links. Hosted features depend on the deployed server version.
Documentation
See the OpenConstruction guide.
Detailed CLI, MCP, catalog, and hosting guides are also bundled under
share/openconstruction/docs in your Python environment and in the source archive.
Developers with repository access can install a checkout with
python -m pip install .. See docs/development.md for checks.
The software is licensed under Apache 2.0; LICENSE and NOTICE are included
in both release archives. Dataset licenses and provider terms apply separately.
Metadata
Release files for openconstruction-tools 0.1.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 |
|---|---|---|---|---|
| openconstruction_tools-0.1.0.tar.gz | 127.2 kB | Without provenance | Details for openconstruction_tools-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| openconstruction_tools-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for openconstruction_tools-0.1.0-py3-none-any.whl |
Total release size: 210.7 kB
Release files / openconstruction_tools-0.1.0.tar.gz
| Download URL | openconstruction_tools-0.1.0.tar.gz |
|---|---|
| Size | 127.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
68b4a0f6066879f0532898445f6362197dffca4a2f714fafc51aec80aec586cf
|
|
BLAKE2b-256 checksum How to use checksums |
85c61b4c0542b0a33bf5b73c00be9c89787916d704b6bd7c586d80e150659c1f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.9
|
Release files / openconstruction_tools-0.1.0-py3-none-any.whl
| Download URL | openconstruction_tools-0.1.0-py3-none-any.whl |
|---|---|
| Size | 83.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f43aca06db819b3e2e2b505416960a7be3b21cf60a48065afe76e28daab84963
|
|
BLAKE2b-256 checksum How to use checksums |
125c3b4c6ccc90f69a3a3a7e1151e19d6e5c24c0dbb92c60c2172ed72fe467d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.9
|
Security for openconstruction-tools 0.1.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.
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.