CadQuery OCP Proxy

7.9.3.1 verified Fri May 01 auth: no python

Proxy package that tracks the cadquery_ocp / cadquery_ocp_novtk version to avoid version mismatches. Version 7.9.3.1, released monthly alongside CadQuery OCP. Use this package to pin the OCP version in your CadQuery projects.

pip install cadquery-ocp-proxy

Common errors

error ModuleNotFoundError: No module named 'cadquery_ocp' ↓

cause The proxy package is installed but does not install cadquery_ocp automatically (it only tracks version).

fix

Install cadquery_ocp separately: pip install cadquery-ocp or pip install cadquery-ocp-proxy cadquery-ocp.

error RuntimeError: OCP version mismatch: expected x.y.z but got a.b.c ↓

cause Another dependency installed a different version of cadquery_ocp.

fix

Create a clean virtual environment and install cadquery-ocp-proxy to the required version. Use pip freeze to lock versions.

Warnings

gotcha Do NOT import directly from cadquery_ocp or cadquery_ocp_novtk. Always import cadquery for your modeling code. ↓

fix Use `import cadquery as cq` and work with the public CadQuery API.

gotcha This proxy does not pin an exact version of cadquery_ocp; it only tracks the version. Version mismatches can occur if multiple packages require different OCP versions. ↓

fix Use a requirements.txt or pip freeze to pin both cadquery and cadquery-ocp-proxy to known compatible versions.

Imports

ocp_vscode
```
from ocp_vscode import show, show_object
```
This proxy enables correct OCP imports for visualization with ocp_vscode.
cadquery
wrong
```
from cadquery_ocp import *
```
correct
```
import cadquery as cq
```
Directly importing from cadquery_ocp is fragile; use cadquery as the public API.

Quickstart

Basic usage: import cadquery as usual. This proxy ensures the correct OCP version is installed.

import cadquery as cq

# Create a simple box
box = cq.Workplane("XY").box(1, 1, 1)

# Export to STL
cq.exporters.export(box, "box.stl")