Skip to main content

Python CAD Tools

Python CAD Tools is an installable, typed Python package for defining shared CAD/BIM models and producing STEP, IFC4, GLB, conceptual SVG/DXF/PDF drawings, quantity schedules, validation reports, and manifests in a headless workflow.

The canonical project identities are:

Licensed under AGPL-3.0-only. Published on PyPI.

Install

pip install "python-cad-tools[all]"

Capability-based extras (cad, bim, mesh, drawings, engineering, visualization) install a subset of the curated, version-tested toolchain. See docs/toolchain.md for the supported-library table, the dependency license policy, and the compatibility verification matrix.

Install for development

Python 3.12 or 3.13 is required.

python3 -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'

An ordinary non-editable installation exposes the same package and command:

python3 -m pip install ./dist/python_cad_tools-*.whl
python-cad --version

Build locally

Building the complete distribution requires Python 3.12 or 3.13 and Node.js 22.15.0. From a fresh checkout, create and activate the Python environment before building the viewer. Activation is important because the viewer staging script reads the installed python-cad-tools version from that environment.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e '.[dev]'

cd viewer
npm ci
npm test
npm run build
cd ..

python -m build --wheel --sdist --outdir dist .
python -m twine check dist/*

The viewer build compiles the private TypeScript source and stages its verified, model-free static shell under src/python_cad_tools/_viewer_static/. The final wheel and source archive are written to dist/. To inspect the viewer while developing its source, run npm run preview from viewer/ after npm run build and open the local URL printed by Vite.

To build and serve an actual CAD project with the locally installed editable package, change to that project's directory and run:

python-cad build
python-cad serve

Create a new project

python-cad init --destination my-cad-project
cd my-cad-project
python -m venv .venv
.venv/bin/pip install python-cad-tools
.venv/bin/python-cad build

The scaffold includes model.py, config.py, pyproject.toml, README.md, .gitignore, and generated/.gitkeep. Edit config.py for dimensions and materials; edit model.py for design elements.

Command line

python-cad --version reports the version from installed distribution metadata. Project operations use explicit subcommands:

python-cad init --destination my-project
python-cad validate --project-root .
python-cad build --project-root . --format step --format quantities
python-cad verify --project-root .
python-cad prepare-site --project-root . --destination _site --base-path /
python-cad serve --project-root . --port 0
python-cad render-ring --project-root . --destination ring
python-cad clean --project-root .

The project root defaults to the current directory. Builds use project locks, unique staging, final-byte verification, and recoverable journaled promotion. validate writes no artifacts; verify independently reproduces the manifest inventory, sizes, SHA-256 values, schemas, and parser checks. render-ring writes 16 perspective PNGs of the model (8 directions at two heights) and a numbered 4×4 sheet of them into a new directory outside the build output, for comparing the model with a photo; they are not build artifacts. prepare-site deploys the packaged model-free viewer without Node, and serve binds to loopback by default. See docs/viewer-delivery.md for ownership, caching, offline, and deployment details.

Python API

Public symbols are imported from their documented modules:

from pathlib import Path

from python_cad_tools.build import BuildOptions, build_project

result = build_project(BuildOptions(project_root=Path(".")))

Project code should preserve stable semantic IDs, keep geometry parametric, and create geometry and metadata together. Generated artifacts are outputs, never design inputs.

python_cad_tools.recipes lets an element opt into parametric BREP IFC geometry (IfcExtrudedAreaSolid/SweptSolid, IfcBooleanResult/CSG) instead of the default tessellated mesh, verified by a topology round-trip after every build. See docs/neutral-model.md#construction-recipes.

Project-owned drawing annotations use the typed, renderer-independent boundary documented in docs/drawing-extensions.md. One annotation set is validated and rendered consistently to SVG, DXF, and PDF before artifact hashes are recorded.

Python CAD Tools is a curated engineering platform with a two-tier authoring contract: verified authoring through the neutral model (Tier 1), and supported-but-unverified direct use of a pinned library such as ifcopenshell or trimesh (Tier 2). See docs/two-tier-contract.md, docs/neutral-model.md, and docs/toolchain.md.

Verification

.venv/bin/ruff check .
.venv/bin/mypy
.venv/bin/pytest -q
.venv/bin/pytest tests/integration -q
.venv/bin/pytest tests/packaging -q
.venv/bin/pytest tests/typing -q
.venv/bin/python -m build --wheel --sdist --outdir dist .
.venv/bin/python -m twine check dist/*

The default pytest command runs the fast unit suite. Integration, packaging, and external typing suites are explicit release gates. Packaging tests inspect wheel and sdist inventories, install the wheel non-editably into an isolated environment outside the checkout, prove the import resolves from that environment's site-packages, and run python-cad --version.

Viewer TypeScript is maintainer source in viewer/; only its verified, model-free production shell is included in the wheel. See docs/build-semantics.md, docs/manifests.md, docs/project-configuration.md, docs/public-api.md, and docs/viewer-delivery.md for detailed reference.

Metadata

Release files for python-cad-tools 0.1.23

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

Source distribution (sdist)

Source distribution for python-cad-tools 0.1.23
File Size Uploaded Provenance Actions
python_cad_tools-0.1.23.tar.gz 1.0 MB Without provenance Details for python_cad_tools-0.1.23.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-cad-tools 0.1.23
File Interpreter ABI Platform Actions
python_cad_tools-0.1.23-py3-none-any.whl Python 3 none any Details for python_cad_tools-0.1.23-py3-none-any.whl

Total release size: 2.1 MB

Release files / python_cad_tools-0.1.23.tar.gz

Download URL python_cad_tools-0.1.23.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
b6cfce82c6506e75817d154f694f91983d0055ec038e321fcc33bcb08cd217b8
BLAKE2b-256 checksum
How to use checksums
4d528a72d26a5b82d07c29245ea65ae86253ceded6025ed72c56909ad9134d9c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.17

Release files / python_cad_tools-0.1.23-py3-none-any.whl

Download URL python_cad_tools-0.1.23-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
825c2a6377e6c76b4c6d1b348c67064887cb7852356ab8e5e5065cfe1b2afdad
BLAKE2b-256 checksum
How to use checksums
f2b2247055e25b01b3bcb1e3f4173f3aef5b2381f3f98719c6be5d8a2e62ee82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.17

Security for python-cad-tools 0.1.23

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

0.1.23 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