build123d

library0.10.0pypypiunverified

A Python CAD programming library for creating parametric 3D models using a scripting approach. Current version is 0.10.0, requiring Python >=3.10 and <3.14. It provides both algebra and builder modes for constructing solids, and is built on top of cadquery-ocp (OpenCascade Python bindings). Release cadence is irregular, with major versions around every few months.

serialization data

pip install build123d

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · BUILD123D

build123d

serializationpythonv0.10.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Box

✓ from build123d import Box

✗ from build123d import Box

Creates a 10x10x10 box and subtracts a cylinder from its top face. Then exports the result as STL.

from build123d import * with BuildPart() as part: Box(10, 10, 10) with Locations((0, 0, 5)): Cylinder(radius=2, height=6, mode=Mode.SUBTRACT) # Export to STL export_stl(part.part, "example.stl") # To view in Jupyter (requires ocp_vscode): # show_object(part.part)

Debug

Known issues

breakingIn v0.10.0, methods `is_null`, `is_valid`, `shape_type` were changed to properties – remove parentheses from calls like `shape.is_valid()` -> `shape.is_valid`.

fix

Change `shape.is_valid()` to `shape.is_valid`, `shape.is_null()` to `shape.is_null`, `shape.shape_type()` to `shape.shape_type`.

affects: >=0.10.0

deprecatedIn v0.9.0, several previously deprecated items were removed, including old-style `S` prefix aliases (e.g., `Solid` instead of `S`). Check release notes for full list.

fix

Use current names: `Solid` instead of `S`, `Face` instead of `F`, etc.

affects: >=0.9.0

gotchaVTK version conflict when upgrading from build123d <=0.8.0 to 0.9.0 or later – old VTK from cadquery-ocp can cause import errors.

fix

Either create a fresh virtual environment, or uninstall VTK and reinstall a compatible version: `pip uninstall vtk && pip install vtk==9.3.1`.

affects: >=0.9.0

gotcha`show_object` only works with the ocp_vscode viewer; if not installed, you'll get an ImportError or runtime error.

fix

Install `pip install ocp_vscode` or use `export_stl`/`export_step` to save files.

affects: All

Upgrade

Version history

0.10.0latest on PyPI · released Nov 5, 2025

Audit

Dependencies

cadquery-ocprequiredOpenCascade Python bindings used for geometric operations

ocp_vscodeoptionalVisualisation in VSCode (recommended for Jupyter or VSCode)

Agent activity

47 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/gumyr/build123d ↗

packagehttps://pypi.org/project/build123d/ ↗

docshttps://build123d.readthedocs.io/en/latest/index.html ↗