Skip to main content

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. Install the package from PyPI:

pip install --upgrade 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 Codex, register the hosted server and authenticate:

codex mcp add openconstruction --url https://mcp.openconstruction.org/mcp
codex mcp login openconstruction

Complete browser sign-in and select Allow access. Wait for the terminal to confirm successful login. If tools are missing from an existing session, restart Codex or its extension and open a new session. See MCP setup and troubleshooting.

For local MCP, install this package and configure your client to launch openconstruction-mcp over stdio. Then ask:

Download the OpenConstruction dataset "CHVG".

Version 0.1.1 adds native license confirmation to local and hosted MCP. Clients supporting MCP form elicitation show a license prompt. Other clients must show the review, ask for agreement, and return its review_id. 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.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 openconstruction-tools 0.1.1
File Size Uploaded Provenance Actions
openconstruction_tools-0.1.1.tar.gz 139.8 kB Without provenance Details for openconstruction_tools-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for openconstruction-tools 0.1.1
File Interpreter ABI Platform Actions
openconstruction_tools-0.1.1-py3-none-any.whl Python 3 none any Details for openconstruction_tools-0.1.1-py3-none-any.whl

Total release size: 234.0 kB

Release files / openconstruction_tools-0.1.1.tar.gz

Download URL openconstruction_tools-0.1.1.tar.gz
Size 139.8 kB
Tags Source
SHA-256 checksum
How to use checksums
c59739be1da650f419b7c12c9fb301ae2ccd49cfc953d82440256bdd1ce950f8
BLAKE2b-256 checksum
How to use checksums
515bbb5275b2b1f3e5fbfdb28e2605f37a80c177343e2d2bcaa08fd89e16e5be
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.1-py3-none-any.whl

Download URL openconstruction_tools-0.1.1-py3-none-any.whl
Size 94.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
42f81617748411505b4b131b93a963fd2659d313491b70adaf427b4c31520277
BLAKE2b-256 checksum
How to use checksums
9b4dc1e691aa2aefd444ff40170d864cedad0e30ccdbb49a859d7d32282d6904
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.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.

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