cad-viewer-widget

A Jupyter widget to view CAD objects

cad-viewer-widgets has its origin in Jupyter-CadQuery, which now has been split into 3 layers. This repo being the middle layer:

three-cad-viewer This is the complete CAD viewer written in Javascript with threejs being the only dependency.
cad-view-widget (this repository) A thin layer on top of cad-viewer-widget that wraps the CAD viewer into an ipywidget. The API documentation can be found here
Jupyter-CadQuery A CadQuery viewer, collecting and tessellating CadQuery objects, using cad-view-widget to visualize the objects

Click on the "launch binder" icon to start cad-viewer-widget on binder:

Examples

Tests and demos: Demonstrating the features using the sample tesssellations in ./examples
Classic OCC Bottle: A real CAD example based on python-occ

Installation

To install use pip:

$ pip install cad_viewer_widget

For a development installation (requires [Node.js](https://nodejs.org >=21.1.0) and Yarn version 1),

$ git clone https://github.com/bernhard-42/cad-viewer-widget.git
$ cd cad-viewer-widget
$ pip install -e . 
$ jupyter labextension develop . --overwrite

When actively developing your extension for JupyterLab, run the command:

$ jupyter labextension develop --overwrite cad_viewer_widget

Then you need to rebuild the JS when you make a code change:

$ cd js
$ yarn run build

You then need to refresh the JupyterLab page when your javascript changes:

save your notebook
restart the kernel
delete all output cells
refresh the browser page

Build step

hatch build

Changes

2023-08-14

Adapt to ocp-tessellate
Support version 1.8.6 of three-cad-viewer
Supports jupyterlab>=4, ipywidgets>=8 and notebook>7
Dropped support for notebook < 7.0
Build process now uses pyproject.toml and hatch

2023-01-03

Added pyparsing as dependency
Pinned traitlets to ~5.8
Upgraded bottle example to occt 7.6.2

Metadata

Release files for cad-viewer-widget 4.1.3

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

Source distribution (sdist)

Source distribution for cad-viewer-widget 4.1.3
File	Size	Uploaded
cad_viewer_widget-4.1.3.tar.gz	792.0 kB	Sep 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cad-viewer-widget 4.1.3
File	Interpreter	ABI	Platform	Reset
cad_viewer_widget-4.1.3-py3-none-any.whl 715.2 kB Sep 14, 2026	Python 3	none	any	Details

Total release size: 1.5 MB

Release files / cad_viewer_widget-4.1.3.tar.gz

Download URL	cad_viewer_widget-4.1.3.tar.gz
Size	792.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`4415ce6edbb0aded151779a1e0022685d2db434d41a898998a0bd785b61fe436`
BLAKE2b-256 checksum How to use checksums	`1c9c9baef5d5ed342be4f02492e92bf32a11b1a6f6a40997da5b150a2a9a56b3`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.12`

Release files / cad_viewer_widget-4.1.3-py3-none-any.whl

Download URL	cad_viewer_widget-4.1.3-py3-none-any.whl
Size	715.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`badef01dc2a78fcf854c81f48c8599be3dbcf05552606388e141038888511e7f`
BLAKE2b-256 checksum How to use checksums	`2732f5abdda3bc8ac5554226025ce2cba71578adb3e5d91700ff2428176b78d6`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.12`